Prima::Const - predefined constants



NAME

Prima::Const - predefined constants


DESCRIPTION

Prima::Const and the Prima::Classes manpage is a minimal set of perl modules needed for the toolkit. Since the module provides bindings for the core constants, it is required to be included in every Prima-related module and program.

The constants are assembled under the top-level package names, with no Prima:: prefix. This violates the perl guidelines about package naming, however, it was considered way too inconvenient to prefix every constant with Prima:: string.

This document provides description of all core-coded constants. The constants are also described in the articles together with the corresponding methods and properties. For example, nt constants are also described in Flow in the Prima::Object manpage article.


API

am:: - Prima::Icon auto masking

See also autoMasking in the Prima::Image manpage

  am::None           - no mask update performed
  am::MaskColor      - mask update based on Prima::Icon::maskColor property
  am::Auto           - mask update based on corner pixel values

apc:: - OS type

See get_system_info in the Prima::Application manpage

  apc::Os2    
  apc::Win32  
  apc::Unix

bi:: - border icons

See borderIcons in the Prima::Window manpage

  bi::SystemMenu  - system menu button and/or close button ( usually with icon ) is shown
  bi::Minimize    - minimize button 
  bi::Maximize    - maximize ( and eventual restore )
  bi::TitleBar    - window title 
  bi::All         - all of the above

bs:: - border styles

See borderStyle in the Prima::Window manpage

  bs::None      - no border
  bs::Single    - thin border
  bs::Dialog    - thick border
  bs::Sizeable  - thick border with interactive resize capabilities

ci:: - color indices

See colorIndex in the Prima::Widget manpage

  ci::NormalText or ci::Fore 
  ci::Normal or ci::Back
  ci::HiliteText
  ci::Hilite
  ci::DisabledText
  ci::Disabled
  ci::Light3DColor
  ci::Dark3DColor
  ci::MaxId

cl:: - colors

See colorIndex in the Prima::Widget manpage

Direct color constants
  mb::Black
  mb::Blue
  mb::Green
  mb::Cyan
  mb::Red
  mb::Magenta
  mb::Brown
  mb::LightGray
  mb::DarkGray
  mb::LightBlue
  mb::LightGreen
  mb::LightCyan
  mb::LightRed
  mb::LightMagenta
  mb::Yellow
  mb::White
  mb::Gray
Indirect color constants
  cl::NormalText, cl::Fore 
  cl::Normal, cl::Back
  cl::HiliteText
  cl::Hilite
  cl::DisabledText
  cl::Disabled
  cl::Light3DColor
  cl::Dark3DColor
  cl::MaxSysColor
Special constants
See Colors in the Prima::gp_problems manpage
  cl::Set      - logical all-1 color
  cl::Clear    - logical all-0 color
  cl::Invalid  - invalid color value
  cl::SysFlag  - indirect color constant bit set
  cl::SysMask  - indirect color constant bit clear mask

cm:: - commands

Keyboard and mouse commands
See key_down in the Prima::Widget manpage, mouse_down in the Prima::Widget manpage
  cm::KeyDown
  cm::KeyUp
  cm::MouseDown
  cm::MouseUp
  cm::MouseClick
  cm::MouseWheel
  cm::MouseMove
  cm::MouseEnter
  cm::MouseLeave

Internal commands ( used in core only or not used at all )
  cm::Close
  cm::Create
  cm::Destroy
  cm::Hide
  cm::Show
  cm::ReceiveFocus
  cm::ReleaseFocus
  cm::Paint
  cm::Repaint
  cm::Size
  cm::Move
  cm::ColorChanged
  cm::ZOrderChanged
  cm::Enable
  cm::Disable
  cm::Activate
  cm::Deactivate
  cm::FontChanged
  cm::WindowState
  cm::Timer
  cm::Click
  cm::CalcBounds
  cm::Post
  cm::Popup
  cm::Execute
  cm::Setup
  cm::Hint
  cm::DragDrop
  cm::DragOver
  cm::EndDrag
  cm::Menu
  cm::EndModal
  cm::MenuCmd
  cm::TranslateAccel
  cm::DelegateKey

cr:: - pointer cursor resources

See pointerType in the Prima::Widget manpage

  cr::Default                 same pointer type as owner's
  cr::Arrow                   arrow pointer
  cr::Text                    text entry cursor-like pointer
  cr::Wait                    hourglass
  cr::Size                    general size action pointer
  cr::Move                    general move action pointer 
  cr::SizeWest, cr::SizeW     right-move action pointer
  cr::SizeEast, cr::SizeE     left-move action pointer 
  cr::SizeWE                  general horizontal-move action pointer 
  cr::SizeNorth, cr::SizeN    up-move action pointer 
  cr::SizeSouth, cr::SizeS    down-move action pointer 
  cr::SizeNS                  general vertical-move action pointer 
  cr::SizeNW                  up-right move action pointer
  cr::SizeSE                  down-left move action pointer
  cr::SizeNE                  up-left move action pointer
  cr::SizeSW                  down-right move action pointer
  cr::Invalid                 invalid action pointer
  cr::User                    user-defined icon

dt:: - drive types

See query_drive_type in the Prima::Utils manpage

  dt::None
  dt::Unknown
  dt::Floppy
  dt::HDD
  dt::Network
  dt::CDROM
  dt::Memory

dt:: - Prima::Drawable::draw_text constants

  dt::Left                  - text is aligned to the left boundary
  dt::Right                 - text is aligned to the right boundary
  dt::Center                - text is aligned horizontally in center
  dt::Top                   - text is aligned to the upper boundary
  dt::Bottom                - text is aligned to the lower boundary 
  dt::VCenter               - text is aligned vertically in center
  dt::DrawMnemonic          - tilde-escapement and underlining is used 
  dt::DrawSingleChar        - sets tw::BreakSingle option to Prima::Drawable::text_wrap call
  dt::NewLineBreak          - sets tw::NewLineBreak option to Prima::Drawable::text_wrap call 
  dt::SpaceBreak            - sets tw::SpaceBreak option to Prima::Drawable::text_wrap call  
  dt::WordBreak             - sets tw::WordBreak option to Prima::Drawable::text_wrap call 
  dt::ExpandTabs            - performs tab character ( \t ) expansion
  dt::DrawPartial           - draws the last line, if it is visible partially 
  dt::UseExternalLeading    - text lines positioned vertically with respect to the font external leading
  dt::UseClip               - assign ::clipRect property to the boundary rectangle
  dt::QueryLinesDrawn       - calculates and returns number of lines drawn ( contrary to dt::QueryHeight )
  dt::QueryHeight           - if set, calculates and returns vertical extension of lines drawn
  dt::NoWordWrap            - performs no word wrapping by the width of the boundaries
  dt::WordWrap              - performs word wrapping by the width of the boundaries 
  dt::Default               - dt::NewLineBreak|dt::WordBreak|dt::ExpandTabs|dt::UseExternalLeading

fdo:: - find / replace dialog options

See the Prima::EditDialog manpage

  fdo::MatchCase
  fdo::WordsOnly
  fdo::RegularExpression
  fdo::BackwardSearch
  fdo::ReplacePrompt

fds:: - find / replace dialog scope type

See the Prima::EditDialog manpage

  fds::Cursor
  fds::Top
  fds::Bottom

fe:: - file events constants

See the Prima::File manpage

  fe::Read
  fe::Write
  fe::Exception

fp:: - standard fill pattern indexes

See fillPattern in the Prima::Drawable manpage

  fp::Empty
  fp::Solid
  fp::Line
  fp::LtSlash
  fp::Slash
  fp::BkSlash
  fp::LtBkSlash
  fp::Hatch
  fp::XHatch
  fp::Interleave
  fp::WideDot
  fp::CloseDot
  fp::SimpleDots
  fp::Borland
  fp::Parquet

fp:: - font pitches

See pitch in the Prima::Drawable manpage

  fp::Default
  fp::Fixed
  fp::Variable

fr:: - fetch resource constants

See fetch_resource in the Prima::Widget manpage

  fr::Color 
  fr::Font  
  fs::String

fs:: - font styles

See style in the Prima::Drawable manpage

  fs::Normal 
  fs::Bold
  fs::Thin
  fs::Italic
  fs::Underlined
  fs::StruckOut
  fs::Outline

fw:: - font weights

See weight in the Prima::Drawable manpage

  fw::UltraLight
  fw::ExtraLight
  fw::Light
  fw::SemiLight
  fw::Medium
  fw::SemiBold
  fw::Bold
  fw::ExtraBold
  fw::UltraBold

gm:: - grow modes

See growMode in the Prima::Widget manpage

Basic constants
  gm::GrowLoX      widget's left side is kept in constant distance from owner's right side
  gm::GrowLoY      widget's bottom side is kept in constant distance from owner's top side 
  gm::GrowHiX      widget's right side is kept in constant distance from owner's right side  
  gm::GrowHiY      widget's top side is kept in constant distance from owner's top side  
  gm::XCenter      widget is kept in center on its owner horizontal axis
  gm::YCenter      widget is kept in center on its owner vertical axis 
  gm::DontCare     widgets origin is maintained constant relative to the screen
Derived or aliased constants
  gm::GrowAll      gm::GrowLoX|gm::GrowLoY|gm::GrowHiX|gm::GrowHiY 
  gm::Center       gm::XCenter|gm::YCenter
  gm::Client       gm::GrowHiX|gm::GrowHiY
  gm::Right        gm::GrowLoX|gm::GrowHiY 
  gm::Left         gm::GrowHiY 
  gm::Floor        gm::GrowHiX

gui:: - GUI types

See get_system_info in the Prima::Application manpage

  gui::Default
  gui::PM  
  gui::Windows
  gui::XLib 
  gui::OpenLook
  gui::Motif

le:: - line end styles

See lineEnd in the Prima::Drawable manpage

  le::Flat
  le::Square
  le::Round

lp:: - predefined line pattern styles

See linePattern in the Prima::Drawable manpage

  lp::Null           #    ""              /*              */
  lp::Solid          #    "\1"            /* ___________  */
  lp::Dash           #    "\x9\3"         /* __ __ __ __  */
  lp::LongDash       #    "\x16\6"        /* _____ _____  */
  lp::ShortDash      #    "\3\3"          /* _ _ _ _ _ _  */
  lp::Dot            #    "\1\3"          /* . . . . . .  */
  lp::DotDot         #    "\1\1"          /* ............ */
  lp::DashDot        #    "\x9\6\1\3"     /* _._._._._._  */
  lp::DashDotDot     #    "\x9\3\1\3\1\3" /* _.._.._.._.. */

im:: - image types

See type in the Prima::Image manpage.

Bit depth constants
  im::bpp1
  im::bpp4
  im::bpp8
  im::bpp16
  im::bpp24
  im::bpp32
  im::bpp64
  im::bpp128
Pixel format constants
  im::Color
  im::GrayScale
  im::RealNumber
  im::ComplexNumber
  im::TrigComplexNumber
Mnemonic image types
  im::Mono          - im::bpp1
  im::BW            - im::bpp1 | im::GrayScale
  im::16            - im::bpp4
  im::Nibble        - im::bpp4
  im::256           - im::bpp8
  im::RGB           - im::bpp24
  im::Triple        - im::bpp24
  im::Byte          - gray 8-bit unsigned integer
  im::Short         - gray 16-bit unsigned integer 
  im::Long          - gray 32-bit unsigned integer 
  im::Float         - float
  im::Double        - double
  im::Complex       - dual float
  im::DComplex      - dual double
  im::TrigComplex   - dual float
  im::TrigDComplex  - dual double
Extra formats
  im::fmtBGR
  im::fmtRGBI
  im::fmtIRGB
  im::fmtBGRI
  im::fmtIBGR
Masks
  im::BPP      - bit depth constants
  im::Category - category constants
  im::FMT      - extra format constants

ict:: - image conversion types

See conversion in the Prima::Image manpage.

  ict::None            - no dithering
  ict::Ordered         - 8x8 ordered halftone dithering
  ict::ErrorDiffusion  - error diffusion dithering with static palette
  ict::Optimized       - error diffusion dithering with optimized palette

is:: - image statistics indeces

See stats in the Prima::Image manpage.

  is::RangeLo  - minimum pixel value
  is::RangeHi  - maximum pixel value
  is::Mean     - mean value
  is::Variance - variance
  is::StdDev   - standard deviation
  is::Sum      - sum of pixel values
  is::Sum2     - sum of squares of pixel values

kb:: - keyboard virtual codes

See also KeyDown in the Prima::Widget manpage.

Modificator keys
  kb::ShiftL   kb::ShiftR   kb::CtrlL      kb::CtrlR
  kb::AltL     kb::AltR     kb::MetaL      kb::MetaR
  kb::SuperL   kb::SuperR   kb::HyperL     kb::HyperR
  kb::CapsLock kb::NumLock  kb::ScrollLock kb::ShiftLock
Keys with character code defined
  kb::Backspace  kb::Tab    kb::Linefeed   kb::Enter
  kb::Return     kb::Escape kb::Esc        kb::Space
Function keys
  kb::F1 .. kb::F30
  kb::L1 .. kb::L10
  kb::R1 .. kb::R10
Other
  kb::Clear    kb::Pause   kb::SysRq  kb::SysReq
  kb::Delete   kb::Home    kb::Left   kb::Up
  kb::Right    kb::Down    kb::PgUp   kb::Prior
  kb::PageUp   kb::PgDn    kb::Next   kb::PageDown
  kb::End      kb::Begin   kb::Select kb::Print
  kb::PrintScr kb::Execute kb::Insert kb::Undo
  kb::Redo     kb::Menu    kb::Find   kb::Cancel
  kb::Help     kb::Break   kb::BackTab
Masking constants
  kb::CharMask - character codes
  kb::CodeMask - virtual key codes ( all other kb:: values )
  kb::ModMask  - km:: values

km:: - keyboard modifiers

See also KeyDown in the Prima::Widget manpage.

  km::Shift
  km::Ctrl
  km::Alt
  km::KeyPad
  km::DeadKey

mt:: - modality types

See get_modal in the Prima::Window manpage, get_modal_window in the Prima::Window manpage

  mt::None
  mt::Shared
  mt::Exclusive

nt:: - notification types

Used in Prima::Component::notification_types to describe event flow.

See also Flow in the Prima::Object manpage.

Starting point constants
  nt::PrivateFirst
  nt::CustomFirst
Direction constants
  nt::FluxReverse
  nt::FluxNormal
Complexity constants
  nt::Single
  nt::Multiple
  nt::Event
Composite constants
  nt::Default       ( PrivateFirst | Multiple | FluxReverse)
  nt::Property      ( PrivateFirst | Single   | FluxNormal )
  nt::Request       ( PrivateFirst | Event    | FluxNormal )
  nt::Notification  ( CustomFirst  | Multiple | FluxReverse )
  nt::Action        ( CustomFirst  | Single   | FluxReverse )
  nt::Command       ( CustomFirst  | Event    | FluxReverse )

mb:: - mouse buttons

See also MouseDown in the Prima::Widget manpage.

  mb::b1 or mb::Left
  mb::b2 or mb::Middle
  mb::b3 or mb::Right
  mb::b4
  mb::b5
  mb::b6
  mb::b7
  mb::b8

mb:: - message box constants

Message box and modal result button commands
See also modalResult in the Prima::Window manpage, modalResult in the Prima::Button manpage.
  mb::OK, mb::Ok
  mb::Cancel
  mb::Yes
  mb::No
  mb::Abort
  mb::Retry
  mb::Ignore
  mb::Help

Message box composite ( multi-button ) constants
  mb::OKCancel, mb::OkCancel
  mb::YesNo
  mb::YesNoCancel
Message box icon and bell constants
  mb::Error
  mb::Warning
  mb::Information
  mb::Question

rop:: - raster operation codes

See Raster operations in the Prima::Drawable manpage

  rop::CopyPut        #   /* dest  = src */
  rop::XorPut         #   /* dest ^= src */
  rop::AndPut         #   /* dest &= src */
  rop::OrPut          #   /* dest |= src */
  rop::NotPut         #   /* dest = !src */
  rop::NotBlack       #   /* dest = (src != 0) ? src : dest */
  rop::NotDestXor     #   /* dest = (!dest) ^ src */
  rop::NotDestAnd     #   /* dest = (!dest) & src */
  rop::NotDestOr      #   /* dest = (!dest) | src */
  rop::NotSrcXor      #   /* dest ^= !src */
  rop::NotSrcAnd      #   /* dest &= !src */
  rop::NotSrcOr       #   /* dest |= !src */
  rop::NotXor         #   /* dest = !(src ^ dest) */
  rop::NotAnd         #   /* dest = !(src & dest) */
  rop::NotOr          #   /* dest = !(src | dest) */
  rop::NotBlackXor    #   /* dest ^= (src != 0) ? src : dest */
  rop::NotBlackAnd    #   /* dest &= (src != 0) ? src : dest */
  rop::NotBlackOr     #   /* dest |= (src != 0) ? src : dest */
  rop::NoOper         #   /* dest = dest */
  rop::Blackness      #   /* dest = black */
  rop::Whiteness      #   /* dest = white */
  rop::Invert         #   /* dest = !dest */
  rop::Pattern        #   /* dest = pattern */
  rop::XorPattern     #   /* dest ^= pattern */
  rop::AndPattern     #   /* dest &= pattern */
  rop::OrPattern      #   /* dest |= pattern */
  rop::NotSrcOrPat    #   /* dest |= pattern | (!src) */
  rop::SrcLeave       #   /* dest = (src != fore color) ? src : dest */
  rop::DestLeave      #   /* dest = (src != back color) ? src : dest */

sbmp:: - system bitmaps indexes

See also the Prima::StdBitmap manpage.

  sbmp::Logo
  sbmp::CheckBoxChecked
  sbmp::CheckBoxCheckedPressed
  sbmp::CheckBoxUnchecked
  sbmp::CheckBoxUncheckedPressed
  sbmp::RadioChecked
  sbmp::RadioCheckedPressed
  sbmp::RadioUnchecked
  sbmp::RadioUncheckedPressed
  sbmp::Warning
  sbmp::Information
  sbmp::Question
  sbmp::OutlineCollaps
  sbmp::OutlineExpand
  sbmp::Error
  sbmp::SysMenu
  sbmp::SysMenuPressed
  sbmp::Max
  sbmp::MaxPressed
  sbmp::Min
  sbmp::MinPressed
  sbmp::Restore
  sbmp::RestorePressed
  sbmp::Close
  sbmp::ClosePressed
  sbmp::Hide
  sbmp::HidePressed
  sbmp::DriveUnknown
  sbmp::DriveFloppy
  sbmp::DriveHDD
  sbmp::DriveNetwork
  sbmp::DriveCDROM
  sbmp::DriveMemory
  sbmp::GlyphOK
  sbmp::GlyphCancel
  sbmp::SFolderOpened
  sbmp::SFolderClosed
  sbmp::Last

sv:: - system value indexes

See also get_system_value in the Prima::Application manpage

  sv::YMenu            - height of menu bar in top-level windows
  sv::YTitleBar        - height of title bar in top-level windows
  sv::XIcon            - width and height of main icon dimensions, 
  sv::YIcon              acceptable by the system
  sv::XSmallIcon       - width and height of alternate icon dimensions,  
  sv::YSmallIcon         acceptable by the system 
  sv::XPointer         - width and height of mouse pointer icon
  sv::YPointer           acceptable by the system  
  sv::XScrollbar       - width of the default vertical scrollbar
  sv::YScrollbar       - height of the default horizontal scrollbar 
  sv::XCursor          - width of the system cursor
  sv::AutoScrollFirst  - the initial and the repetitive 
  sv::AutoScrollNext     scroll timeouts
  sv::InsertMode       - the system insert mode
  sv::XbsNone          - widths and heights of the top-level window
  sv::YbsNone            decorations, correspondingly, with borderStyle
  sv::XbsSizeable        bs::None, bs::Sizeable, bs::Single, and
  sv::YbsSizeable        bs::Dialog. 
  sv::XbsSingle          
  sv::YbsSingle
  sv::XbsDialog
  sv::YbsDialog
  sv::MousePresent     - 1 if the mouse is present, 0 otherwise
  sv::MouseButtons     - number of the mouse buttons
  sv::WheelPresent     - 1 if the mouse wheel is present, 0 otherwise
  sv::SubmenuDelay     - timeout ( in ms ) before a sub-menu shows on an implicit selection
  sv::FullDrag         - 1 if the top-level windows are dragged dynamically, 0 - with marquee mode
  sv::DblClickDelay    - mouse double-click timeout in milliseconds
  sv::ShapeExtension   - 1 if Prima::Widget::shape functionality is supported, 0 otherwise
  sv::ColorPointer     - 1 if system accepts color pointer icons.
  sv::CanUTF8_Input    - 1 if system can generate key codes in unicode 
  sv::CanUTF8_Output   - 1 if system can output utf8 text

ta:: - alignment constants

Used in: the Prima::InputLine manpage, the Prima::ImageViewer manpage, the Prima::Label manpage, the Prima::Terminals manpage.

  ta::Left
  ta::Right
  ta::Center

  ta::Top
  ta::Bottom
  ta::Middle

tw:: - text wrapping constants

See text_wrap in the Prima::Drawable manpage

  tw::CalcMnemonic    - calculates tilde underline position
  tw::CollapseTilde   - removes escaping tilde from text
  tw::CalcTabs        - wraps text with respect to tab expansion
  tw::ExpandTabs      - expands tab characters
  tw::BreakSingle     - determines if text is broken to single characters when text cannot be fit
  tw::NewLineBreak    - breaks line on newline characters 
  tw::SpaceBreak      - breaks line on space or tab characters
  tw::ReturnChunks    - returns wrapped text chunks
  tw::ReturnLines     - returns positions and lengths of wrapped text chunks
  tw::WordBreak       - defines if text break by width goes by the characters or by the words
  tw::ReturnFirstLineLength - returns length of the first wrapped line 
  tw::Default         - tw::NewLineBreak|tw::CalcTabs|tw::ExpandTabs|tw::ReturnLines|tw::WordBreak)

wc:: - widget classes

See widgetClass in the Prima::Widget manpage

  wc::Undef
  wc::Button
  wc::CheckBox
  wc::Combo
  wc::Dialog
  wc::Edit
  wc::InputLine
  wc::Label
  wc::ListBox
  wc::Menu
  wc::Popup
  wc::Radio
  wc::ScrollBar
  wc::Slider
  wc::Widget, wc::Custom
  wc::Window
  wc::Application

ws:: - window states

See windowState in the Prima::Window manpage

  ws::Normal
  ws::Minimized
  ws::Maximized


AUTHOR

Dmitry Karasik, <dmitry@karasik.eu.org>.


SEE ALSO

Prima, the Prima::Classes manpage

 Prima::Const - predefined constants