SYSCALLS/GPR - graphics primitives calls 84/04/06
Include files:
C: /sys/ins/gpr.ins.c
Fortran: /sys/ins/gpr.ins.ftn
Pascal: /sys/ins/gpr.ins.pas
Procedures:
not_obscured := gpr_$acquire_display (status)
Acquires use of the display in direct graphics mode and tells
whether the window was obscured.
gpr_$additive_blt (src_bitmap, src_window, src_plane, dst_origin, status)
Does a bit block transfer from a rectangle of a given plane
in a given source bitmap to corresponding rectangle of all
planes based at destination origin in current bitmap.
gpr_$allocate_attribute_block (attrib, status)
Allocates an attribute block initialized to defaults.
gpr_$allocate_bitmap (size, hi_plane, attributes, bitmap, status)
Allocates a memory bitmap.
gpr_$allocate_bitmap_nc (size, hi_plane, attributes, bitmap, status)
Allocates a memory bitmap without clearing it.
gpr_$allocate_hdm_bitmap (size, hi_plane, attributes, bitmap, status)
Allocates a hidden display memory bitmap.
attrib := gpr_$attribute_block (bitmap, status)
Returns descriptor of current bitmap's attribute block.
gpr_$bit_blt (src_bitmap, src_window, src_plane, dst_origin,
dst_plane, status)
Does a bit block transfer from a rectangle of a given plane
in a given source bitmap to corresponding rectangle of a
given plane based at destination origin in current bitmap.
gpr_$clear (val, status)
Clears whole current bitmap to given pixel value.
gpr_$close_fill_pgon (status)
Closes the definition of the current polygon and fills it in the
current bitmap.
gpr_$close_return_pgon (list_size, trap_list, n_traps, status)
Closes the definition of the current polygon and returns the
trapezoid list of its trapezoidal decomposition.
gpr_$color_zoom (x_zoom, y_zoom, status)
Causes color display to use the given zoom factors.
not_obscured := gpr_$cond_event_wait (event_type, event_char, event_pos,
status)
Returns immediately and reports an input event if there was one,
also telling whether the window was obscured.
gpr_$deallocate_attribute_block (attrib, status)
Deallocates an attribute block.
gpr_$deallocate_bitmap (bitmap, status)
Deallocates a memory bitmap.
gpr_$disable_input (event_type, status)
Disables reporting of input events of the given type.
gpr_$enable_direct_access (status)
Waits for display hardware to finish current operations to allow
safe direct access to display memory.
gpr_$enable_input (event_type, key_set, status)
Enables reporting of input events of the given type that are
included in the given key set.
not_obscured := gpr_$event_wait (event_type, event_char, event_pos, status)
Waits for the next input event and reports it when it arrives,
also telling whether the window was obscured.
gpr_$force_release (acquire_count, status)
Force a release of an acquired display in direct graphics mode
and reports how many acquire operations were pending.
gpr_$get_ec (gpr_key, ec_pointer, status)
Gets the event count pointer for gpr input events.
gpr_$init (op_mode, unit_or_pad, size, hi_plane, init_bitmap, status)
Initializes graphics primitives.
gpr_$inq_bitmap (bitmap, status)
Returns descriptor of current bitmap.
gpr_$inq_bitmap_dimensions (bitmap, size, hi_plane, status)
Returns size and highest plane number of given bitmap.
gpr_$inq_bitmap_pointer (bitmap, storage_ptr, line_width, status)
Returns virtual address of bitmap and number of words between
successive scan lines.
gpr_$inq_bm_bit_offset (bitmap, bit_offset, status)
Returns the offset of the left edge of the given bitmap from
the next lower 16-bit word boundary.
gpr_$inq_color_map (start_index, n_entries, vector, status)
Returns color map contents.
gpr_$inq_config (config, status)
Returns current display configuration.
gpr_$inq_constraints (window, active, mask, status)
Returns clipping window, clipping active status and plane mask
for current bitmap.
gpr_$inq_coordinate_origin (origin, status)
Returns origin of x and y coordinates for current bitmap.
gpr_$inq_cp (x, y, status)
Returns CP for current bitmap.
gpr_$inq_cursor (cursor, ops, active, pos, origin, status)
Returns cursor information.
gpr_$inq_draw_value (val, status)
Returns pixel value that lines are drawn in for current bitmap.
gpr_$inq_fill_value (val, status)
Returns pixel value for filled areas for current bitmap.
gpr_$inq_imaging_format (format, status)
Returns the current DN600 display format.
gpr_$inq_line_pattern (repeat_count, pattern, length, status)
Retrieves the pattern used in drawing lines.
gpr_$inq_linestyle (style, scale, status)
Returns line style and dashing scale factor for current bitmap.
gpr_$inq_raster_ops (ops, status)
Returns raster ops for all planes of current bitmap.
gpr_$inq_text (font_id, path, status)
Returns text font and text path for current bitmap.
gpr_$inq_text_extent (str, strlen, size, status)
Returns x and y sizes of text string if it were written in
current bitmap.
gpr_$inq_text_offset (str, strlen, start_offset, x_end, status)
Returns x-, y-offsets from upper left pixel of string to position
from which string should be written, and x-offset from same place
to pixel which will be the new CP after the string is written.
gpr_$inq_text_values (val, status)
Returns pixel values for text foreground and background for current
bitmap.
gpr_$inq_vis_list (list_size, n_slots, vis_list, status)
Returns a list of visible subwindows for a direct graphics window.
gpr_$inq_window_id (id_char, status)
Returns the character identifying the current displayed bitmap for
input identification purposes.
gpr_$line (x, y, status)
Draws a line from CP to (x, y) in current bitmap, updates CP.
gpr_$load_font_file (pathname, pnlength, font_id, status)
Loads a font for use in any bitmap, returns its id.
gpr_$move (x, y, status)
Sets current position ("CP") of current bitmap to (x, y).
gpr_$multiline (x_array, y_array, npoints, status)
Does alternating GPR_$MOVEs and GPR_$DRAWs, updates CP.
gpr_$multitrapezoid (trap_list, n_traps, status)
Does a series of GPR_$TRAPEZOIDs.
gpr_$open_bitmap_file (access, filename, namesize, version, size, groups,
g_headers, attribs, bitmap, created, status)
Opens a file for external storage of a bitmap.
gpr_$pgon_polyline (x_array, y_array, npoints, status)
Defines a list of connected edges in the current polygon definition.
gpr_$pixel_blt (src_bitmap, src_window, dst_origin, status)
Does a pixel block transfer from a rectangle in given source
bitmap to corresponding rectangle based at destination origin
in current bitmap.
gpr_$polyline (x_array, y_array, npoints, status)
Does a series of GPR_$LINEs, updates CP.
gpr_$read_pixels (src_window, pix_array, status)
Reads a rectangle of pixels from current bitmap into pixel array.
gpr_$rectangle (rect_window, status)
Fills the given rectangle in the current bitmap.
gpr_$release_display (status)
Releases one level of display acquires for direct graphics mode.
gpr_$remap_color_memory (plane, status)
Sets the plane of frame 0 of color display memory mapped at
the address returned by GPR_$INQ_BITMAP_POINTER.
gpr_$remap_color_memory_1 (plane, status)
Sets the plane of frame 1 of color display memory mapped at
the address returned by GPR_$INQ_BITMAP_POINTER.
gpr_$select_color_frame (frame, status)
Selects which frame, 0 or 1, of color display memory is visible.
gpr_$set_acq_time_out (timeout, status)
Sets the timeout period for an acquired display in direct graphics
mode.
gpr_$set_attribute_block (attrib, status)
Establishes an attribute block as the attributes for the current bitmap.
gpr_$set_auto_refresh (auto_refresh_flag, status)
Establishes whether the display manager will automatically save and
refresh the contents of an acquired display window in direct graphics
mode.
gpr_$set_bitmap (bitmap, status)
Establishes new current bitmap.
gpr_$set_bitmap_dimensions (bitmap, size, hi_plane, status)
Changes size and number of planes of given bitmap.
gpr_$set_clip_window (window, status)
Sets clipping window for current bitmap.
gpr_$set_clipping_active (active, status)
Turns on/off clipping for current bitmap.
gpr_$set_color_map (start_index, n_entries, vector, status)
Gives new color map contents.
gpr_$set_coordinate_origin (origin, status)
Sets origin of x and y coordinates for current bitmap.
gpr_$set_cursor_active (active, status)
Turns cursor on/off.
gpr_$set_cursor_origin (origin, status)
Gives new origin pixel for cursor.
gpr_$set_cursor_pattern (cursor, status)
Gives new bitmap for cursor.
gpr_$set_cursor_position (pos, status)
Moves cursor.
gpr_$set_draw_value (val, status)
Sets pixel value for lines to be drawn in for current bitmap.
gpr_$set_fill_value (val, status)
Sets pixel value for filled areas for current bitmap.
gpr_$set_imaging_format (format, status)
Sets the DN600 display format.
gpr_$set_input_sid (pad_stream_id, status)
Sets stream id for gpr input in frame mode if not using standard
input stream.
gpr_$set_line_pattern (repeat_count, pattern, length, status)
Specifies the pattern used in drawing lines.
gpr_$set_linestyle (style, scale, status)
Sets line drawing style and dashing scale factor for current
bitmap.
gpr_$set_plane_mask (mask, status)
Sets mask defining planes which can be modified by gpr calls.
gpr_$set_obscured_opt(if_obscured, status)
Sets option controlling behavior of GPR_$ACQUIRE if the window
is obscured.
gpr_$set_raster_op (plane, op, status)
Sets raster operation opcode for a plane of the current bitmap.
gpr_$set_refresh_entry (refresh_win_proc, refresh_hdm_proc, status)
Sets two program entry points, one for acquired display and one
for hidden display memory, which will be called when the corresponding
area needs to be redrawn.
gpr_$set_text_font (font_id, status)
Sets text font for current bitmap.
gpr_$set_text_background_value (val, status)
Sets pixel value for text background bits.
gpr_$set_text_value (val, status)
Sets pixel value for text foreground bits.
gpr_$set_window_id (id_char, status)
Sets the character identifying the current displayed bitmap for
input identification purposes.
gpr_$start_pgon (x, y, status)
Starts a connected loop of polygon edges at the given point
in the current bitmap.
gpr_$terminate (delete, status)
Terminates graphics primitives.
gpr_$text (str, strlen, status)
Writes text string in current bitmap starting at CP,
updates CP.
gpr_$trapezoid (trapezoid, status)
Fills the given trapezoid in the current bitmap.
gpr_$triangle (p1, p2, p3, status)
Fills the triangle with the given vertices in the current bitmap.
gpr_$unload_font_file (font_id, status)
Unloads a font file.
gpr_$wait_frame (status)
Causes color display to defer further operations until next
end-of-frame.
gpr_$write_pixels (pix_array, dst_window, status)
Writes a rectangle of pixels into current bitmap from pixel array.