rasops_init man page on MirBSD

Man page or keyword search:  
man Server   6113 pages
apropos Keyword Search (all sections)
Output format
MirBSD logo
[printable version]

RASOPS(9)		      BSD Kernel Manual			     RASOPS(9)

NAME
     rasops, rasops_init, rasops_reconfig - raster display operations

SYNOPSIS
     #include <dev/wscons/wsdisplayvar.h>
     #include <dev/rasops/rasops.h>

     int
     rasops_init(struct rasops_info *ri, int wantrows, int wantcols);

     int
     rasops_reconfig(struct rasops_info *ri, int wantrows, int wantcols);

DESCRIPTION
     The rasops subsystem is a set of raster operations for wscons(9).

     The primary data type for using the raster operations is the rasops_info
     structure in dev/rasops/rasops.h:

     struct rasops_info {

	     /*
	      * These must be filled in by the caller
	      */
	     int     ri_depth;	     /* depth in bits */
	     u_char  *ri_bits;	     /* ptr to bits */
	     int     ri_width;	     /* width (pels) */
	     int     ri_height;	     /* height (pels) */
	     int     ri_stride;	     /* stride in bytes */

	     /*
	      * These can optionally be left zeroed out. If you fill ri_font,
	      * but aren't using wsfont, set ri_wsfcookie to -1.
	      */
	     struct  wsdisplay_font *ri_font;
	     int     ri_wsfcookie;   /* wsfont cookie */
	     void    *ri_hw;	     /* driver private data */
	     int     ri_crow;	     /* cursor row */
	     int     ri_ccol;	     /* cursor column */
	     int     ri_flg;	     /* various operational flags */

	     /*
	      * These are optional and will default if zero. Meaningless
	      * on depths other than 15, 16, 24 and 32 bits per pel. On
	      * 24 bit displays, ri_{r,g,b}num must be 8.
	      */
	     u_char  ri_rnum;	     /* number of bits for red */
	     u_char  ri_gnum;	     /* number of bits for green */
	     u_char  ri_bnum;	     /* number of bits for blue */
	     u_char  ri_rpos;	     /* which bit red starts at */
	     u_char  ri_gpos;	     /* which bit green starts at */
	     u_char  ri_bpos;	     /* which bit blue starts at */

	     /*
	      * These are filled in by rasops_init()
	      */
	     int     ri_emuwidth;    /* width we actually care about */
	     int     ri_emuheight;   /* height we actually care about */
	     int     ri_emustride;   /* bytes per row we actually care about */
	     int     ri_rows;	     /* number of rows (characters) */
	     int     ri_cols;	     /* number of columns (characters) */
	     int     ri_delta;	     /* row delta in bytes */
	     int     ri_pelbytes;    /* bytes per pel (may be zero) */
	     int     ri_fontscale;   /* fontheight * fontstride */
	     int     ri_xscale;	     /* fontwidth * pelbytes */
	     int     ri_yscale;	     /* fontheight * stride */
	     u_char  *ri_origbits;   /* where screen bits actually start */
	     int     ri_xorigin;     /* where ri_bits begins (x) */
	     int     ri_yorigin;     /* where ri_bits begins (y) */
	     int32_t ri_devcmap[16]; /* color -> framebuffer data */

	     /*
	      * The emulops you need to use, and the screen caps for wscons
	      */
	     struct  wsdisplay_emulops ri_ops;
	     int     ri_caps;

	     /*
	      * Callbacks so we can share some code
	      */
	     void    (*ri_do_cursor)(struct rasops_info *);
	     void    (*ri_updatecursor)(struct rasops_info *);
     };

     Valid values for the ri_flg member are:

	   RI_FULLCLEAR	  eraserows() hack to clear full screen
	   RI_FORCEMONO	  monochrome output even if we can do color
	   RI_BSWAP	  framebuffer endianness doesn't match CPU
	   RI_CURSOR	  cursor is switched on
	   RI_CLEAR	  clear display on startup
	   RI_CENTER	  center onscreen output
	   RI_CURSORCLIP  cursor is currently clipped
	   RI_CFGDONE	  rasops_reconfig() completed successfully

FUNCTIONS
     rasops_init(ri, wantrows, wantcols)
	      Initialise a rasops_info descriptor. The arguments wantrows and
	      wantcols are the number of rows and columns we'd like. In terms
	      of optimization, fonts that are a multiple of 8 pixels wide work
	      the best.

     rasops_reconfig(ri, wantrows, wantcols)
	      Reconfigure a rasops_info descriptor because parameters have
	      changed in some way. The arguments wantrows and wantcols are the
	      number of rows and columns we'd like. If calling
	      rasops_reconfig() to change the font and ri_wsfcookie >= 0, you
	      must call wsfont_unlock() on it, and reset it to -1 (or a new,
	      valid cookie).

CODE REFERENCES
     This section describes places within the OpenBSD source tree where actual
     code implementing or utilising the rasops subsystem can be found. All
     pathnames are relative to /usr/src.

     The rasops subsystem is implemented within the directory sys/dev/rasops.
     The rasops module itself is implemented within the file
     sys/dev/rasops/rasops.c.

SEE ALSO
     intro(9)

HISTORY
     The rasops subsystem appeared in NetBSD 1.5 and OpenBSD first support ap-
     peared in OpenBSD 2.9.

AUTHORS
     The rasops subsystem was written by Andrew Doran <ad@NetBSD.org>.

MirOS BSD #10-current	       October 7, 2001				     1
[top]

List of man pages available for MirBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net