Video_Functions

From ArchaicPixels: HuC and PCEAS Documentation

Jump to: navigation, search

Contents

Video Functions

Overview of PCE Graphics -- Tutorial on how to make graphics for the PCE/HuC


disp_off

void disp_off(void); 
     Blank the display.


disp_on

void disp_on(void); 
     Enable display output.


cls

void cls(void);
void cls(int val); 
     Clear all the screen. Without parameters the screen
     is filled with a space character, else it's filled
     with the bat-value given as argument.


vsync

void vsync(void);
void vsync(char nb_frame); 
     Synchronize your program to the video vertical blanking
     signal (VBL), which is 1/60th of a second.
     Without parameters this function return as soon as
     a VBL signal has been received, else your program will
     be synchronized to the number of frame you requested.
     So for example to run your game at 20fps, just use
     vsync(3) at the end of your game loop.


vreg

void vreg(char idx);
void vreg(char idx, int val); 
     This function gives you direct access to the video
     processor (VDC) registers. The first form of this function
     is used to just select a VDC register (for custom accesses),
     and the second is used to set the value of a register
     (it also selects this register).


vram_addr

int vram_addr(char x, char y); 
     Simple function to return the screen video memory address
     of the character located at position x/y.


set_screen_size

void set_screen_size(char size); 
     Change the virtual screen size. By default the startup
     code initialize a virtual screen of 64 characters wide
     and 32 character tall, but other values are possible,
     namely : 32x32, 128x32, 32x64, 64x64, or 128x64.
     More the virtual screen is big, less video memory
     you have for your graphics (font, tiles, sprites).


load_vram

void load_vram(int vaddr, int *data, int nb); 
     Generic function to load data (BAT, CG, sprites)
     in video memory, at address 'vaddr'.
     'nb' is the number of 16-bit words to load.


load_bat

void load_bat(int vaddr, int *bat_data, char w, char h); 
     Load a rectangular character attribute table (BAT)
     of width 'w' and of height 'h' in video memory,
     at address 'vaddr'.


load_background

void load_background(char *gfx, int *pal, int *bat, char width, char height); 
     This function is an all-in-one function, it is used
     to display a whole background image on the screen, like
     a game title image. It will load BG character data,
     it will load the palette, and finaly if will load the BAT.
     Use it with directives #incchr, #incpal and #incbat
     to manage the different type of data. The BG character
     data will be stored at address 0x1000 to 0x5000 in video
     memory.


set_xres

void set_xres(int xres);
[ 1.5+ ]

void set_xres(int x_resolution, int color_correct_flag);
[ 3.11+ ]

     Change the horizontal resolution to 'xres' (in pixels).
     This changes the video controller's registers to display
     more pixels on the screen; it does not affect virtual
     calculations.

     color_correct_flag indicates what kind of smoothing must be
     used, XRES_SHARP or XRES_SOFT.

     The 5MHz dot clock will be used up to horizontal resolutions
     of 268.  7 MHz dot clok will be used up to 356.  10MHz dot clock
     will be used beyond this.  Maximum visible resolution seems to be
     about 512.
Retrieved from "http://www.archaicpixels.com/index.php/Video_Functions"
Personal tools