Silverfrost Logo About Us | Contact Us
 

%gr - Graphics Region

Purpose

To provide a rectangular area for use with drawing surface routines.

Syntax

winio@('%gr[options]', widthheight)
winio@('%`gr[options]', widthheight, handle)
integer widthheight, handle     (input)

Modifiers

Grave accent (`) - used to input a handle for the graphics area.

Caret (^) - used to supply a call-back function.

Question mark (?) - a help string is supplied.

Description

width and height provide the pixel dimensions of the area. handle is a programmer-supplied handle to distinguish between different graphics areas.

%gr can be preceded with %pv in order to re-size the area at run time. For more details about this very versatile feature you should see the section: Graphics Topics.

BLACK, WHITE, RED, BLUE, YELLOW, GREY (or GRAY)

Specifies the initial background colour of the drawing surface. Otherwise this defaults to the background colour of the surrounding window.

COLOUR=#rrggbb

COLOR=#rrggbb

Specifies the intial background colour of the drawing surface where rr represents hexadecimal digits for the red component etc..

METAFILE_RESIZE USER_RESIZE

Options specifying the behaviour of the graphics area as it is re-sized. See later in this chapter.

RGB_COLOURS

Selects RGB colour mode. This is the default for ClearWin+ releases including and after FTN95 7.00.

VGA_COLOURS

Selects VGA colour mode. This is the default for ClearWin+ releases before FTN95 7.00.

FULL_MOUSE_INPUT

Specifies that mouse movements and mouse button releases should be notified to the call-back function, not just clicks and double clicks.

POPUP

Used with FULL_MOUSE_INPUT in order to enable a %pm popup menu that is otherwise disabled.

BOX_SELECTION

LINE_SELECTION

FREE_SELECTION

Specifies the initial selection mode, that controls the behaviour when the user presses the left mouse button and drags the mouse over the graphics area. These options are useful for interactive programs.

USER_SURFACE

A Win32-only option to enable software to access the in-memory copy of the graphics area so as to modify it at the highest possible speed. This option is particularly useful for image processing software.

FLUSH

Used with %sy 3d-styles to re-align the %gr border.

SMOOTH4 Use high-resolution 8x4 box filter anti-aliasing
SMOOTH8 Use 8x8 box filter anti-aliasing

See also

%dw - Ownder Draw Graphics

 

 

Copyright © 1999-2017 Silverfrost Limited