X-Git-Url: http://git.subgeniuskitty.com/screensavers/.git/blobdiff_plain/2c7168aee9615d18be64807d9524ea47ac0bfaf4..37f7b288175b9d8f5ff627d6d997d8df8bb939b8:/hacks/NEDsim/NEDsim.c diff --git a/hacks/NEDsim/NEDsim.c b/hacks/NEDsim/NEDsim.c index 71e4b99..8331334 100644 --- a/hacks/NEDsim/NEDsim.c +++ b/hacks/NEDsim/NEDsim.c @@ -4,6 +4,66 @@ #include "screenhack.h" #include "simulator.h" +/* -------------------------------------------------------------------------- */ +/* Front Panel Layout */ +/* -------------------------------------------------------------------------- */ + +// All of these values are in units of 'cells', not 'pixels'. Where applicable, +// coordinates refer to the upper-left corner of a cell. See the files +// `layout_reference.*` for details. + +#define OVERALL_WIDTH_IN_CELLS 70 +#define HEADER_HEIGHT_IN_CELLS 14 +#define FOOTER_HEIGHT_IN_CELLS 2 + +#define LOGO_X_OFFSET 2 +#define LOGO_Y_OFFSET 2 +#define LOGO_WIDTH 20 +#define LOGO_NAME_HEIGHT 6 +#define LOGO_WEBSITE_HEIGHT 2 + +#define HALT_X_OFFSET 26 +#define HALT_Y_OFFSET 2 +#define HALT_WIDTH 6 +#define HALT_LIGHT_HEIGHT 6 +#define HALT_LABEL_HEIGHT 2 + +#define WORDLINE_BITS_PER_STRIPE 4 +#define WORDLINE_WIDTH 32 +#define WORDLINE_HEIGHT 1 + +#define PC_X_OFFSET 36 +#define PC_Y_OFFSET 7 +#define PC_WIDTH 32 +#define PC_LABEL_HEIGHT 2 +#define PC_LIGHT_HEIGHT 1 + +#define SC_X_OFFSET 42 +#define SC_Y_OFFSET 2 +#define SC_WIDTH 5 +#define SC_LABEL_HEIGHT 2 +#define SC_LIGHT_HEIGHT 1 + +#define PSW_N_X_OFFSET 51 +#define PSW_Z_X_OFFSET 58 +#define PSW_Y_OFFSET 2 +#define PSW_LABEL_WIDTH 3 +#define PSW_LABEL_HEIGHT 2 +#define PSW_LIGHT_WIDTH 1 +#define PSW_LIGHT_HEIGHT 1 + +#define STACK_X_OFFSET 2 +#define STACK_Y_OFFSET 12 +#define STACK_WIDTH 32 +#define STACK_LABEL_HEIGHT 2 +#define STACK_LIGHT_HEIGHT 1 + +#define HEAP_X_OFFSET 36 +#define HEAP_Y_OFFSET 12 +#define HEAP_WIDTH 32 +#define HEAP_LABEL_HEIGHT 2 +#define HEAP_LIGHT_HEIGHT 1 + /* -------------------------------------------------------------------------- */ /* Data Structures */ /* -------------------------------------------------------------------------- */ @@ -126,7 +186,7 @@ static struct color_scheme color_list[] = { /* Helper Functions */ /* -------------------------------------------------------------------------- */ -// TODO: Explain +// Set foreground color for the current graphics context. static void set_color(struct NEDsim * nedsim, struct color_rgb * color) { @@ -143,9 +203,8 @@ set_color(struct NEDsim * nedsim, struct color_rgb * color) XSetForeground(nedsim->dpy, nedsim->gc, temp.pixel); } -// TODO: Explain // TODO: Make this a lot faster. -// Input: size in 'cells', and sets font to fill that size, minus border and padding room. +// Set font size to fill 'size' cells vertically, minus space for border and padding. static void set_font_size(struct NEDsim * nedsim, int size) { @@ -199,8 +258,9 @@ set_font_size(struct NEDsim * nedsim, int size) nedsim->current_font = font_full_name; } -// TODO: Explain -// TODO: Explain that this returns result in pixels so we can track fractional cell usage. +// Unlike most functions in this program that input/output in units of 'cells', +// this function uses units of 'pixels' so the caller can track fractional cell +// usage (e.g. for centering the text). static void get_text_size(struct NEDsim * nedsim, const char * text, int * x_size, int * y_size) { @@ -212,13 +272,14 @@ get_text_size(struct NEDsim * nedsim, const char * text, int * x_size, int * y_s *y_size = overall.ascent - overall.descent; } -// TODO: Explain -// TODO: Note that this might leave the foreground color changed. -// Argument coordinates are in 'cells', not pixels. +// When specifying the rectangular area to draw, all coordinates and sizes are +// in units of 'cells'. Also, be aware that this function alters the +// foreground color. static void draw_rect_area(struct NEDsim * nedsim, size_t x_origin, size_t y_origin, size_t x_size, size_t y_size, Bool bord_top, Bool bord_bottom, Bool bord_left, Bool bord_right) { + // First fill in the rectangular area... x_origin *= nedsim->cell_size; x_origin += nedsim->origin_x_offset; y_origin *= nedsim->cell_size; @@ -227,25 +288,29 @@ draw_rect_area(struct NEDsim * nedsim, size_t x_origin, size_t y_origin, size_t y_size *= nedsim->cell_size; XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, x_origin, y_origin, x_size, y_size); + // ...then give it a border, if requested. set_color(nedsim, &color_list[nedsim->color_index].border); if (bord_top) { - XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, x_origin, y_origin, x_size, nedsim->border_size); + XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, + x_origin, y_origin, x_size, nedsim->border_size); } if (bord_bottom) { - XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, x_origin, (y_origin + y_size - nedsim->border_size), x_size, nedsim->border_size); + XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, + x_origin, (y_origin + y_size - nedsim->border_size), x_size, nedsim->border_size); } if (bord_left) { - XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, x_origin, y_origin, nedsim->border_size, y_size); + XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, + x_origin, y_origin, nedsim->border_size, y_size); } if (bord_right) { - XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, (x_origin + x_size - nedsim->border_size), y_origin, nedsim->border_size, y_size); + XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, + (x_origin + x_size - nedsim->border_size), y_origin, nedsim->border_size, y_size); } } -// TODO: Explain -// Arguments are in units of 'cells', not pixels. -// Will leave foreground color changed. -// Draws filled circle with upper left corner at x,y. +// Draws filled circle in a square area with upper left corner at x,y. When +// specifying the location and size to draw, all values are in units of +// 'cells'. Also, be aware that this function alters the foreground color. static void draw_circular_area(struct NEDsim * nedsim, size_t x, size_t y, double diameter) { @@ -273,15 +338,11 @@ draw_circular_area(struct NEDsim * nedsim, size_t x, size_t y, double diameter) XFillArc(nedsim->dpy, nedsim->panel, nedsim->gc, x, y, diameter, diameter, 0, 360*64); } -// TODO: Explain +// Draws the panel itself. Not the lights/labels/etc, but the flat sheet of +// metal that is the front panel. static void draw_panel(struct NEDsim * nedsim) { -// TODO: Collect all relevant #defines somewhere. -#define OVERALL_WIDTH_IN_CELLS 70 -#define HEADER_HEIGHT_IN_CELLS 14 -#define FOOTER_HEIGHT_IN_CELLS 2 - // Draw background color over entire window. set_color(nedsim, &color_list[nedsim->color_index].panel_bg); XFillRectangle(nedsim->dpy, nedsim->panel, nedsim->gc, 0, 0, nedsim->dpy_width, nedsim->dpy_height); @@ -349,16 +410,10 @@ draw_panel(struct NEDsim * nedsim) ); } -// TODO: Explain +// Draw the "NED" and "subgeniuskitty.com" logos on the front panel. static void draw_logo(struct NEDsim * nedsim) { -#define LOGO_X_OFFSET 2 -#define LOGO_Y_OFFSET 2 -#define LOGO_WIDTH 20 -#define LOGO_NAME_HEIGHT 6 -#define LOGO_WEBSITE_HEIGHT 2 - // First draw the two colored boxes that comprise the logo area. set_color(nedsim, &color_list[nedsim->color_index].primary); draw_rect_area(nedsim, LOGO_X_OFFSET, LOGO_Y_OFFSET, LOGO_WIDTH, LOGO_NAME_HEIGHT, True, True, False, False); @@ -384,16 +439,10 @@ draw_logo(struct NEDsim * nedsim) ((LOGO_Y_OFFSET+LOGO_NAME_HEIGHT+LOGO_WEBSITE_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), "subgeniuskitty.com", 18); } -// TODO: Explain +// Draw the HALT indicator area on the front panel. static void draw_halt(struct NEDsim * nedsim) { -#define HALT_X_OFFSET 26 -#define HALT_Y_OFFSET 2 -#define HALT_WIDTH 6 -#define HALT_LIGHT_HEIGHT 6 -#define HALT_LABEL_HEIGHT 2 - // First draw the two colored boxes that comprise the halt area. set_color(nedsim, &color_list[nedsim->color_index].tertiary); draw_rect_area(nedsim, HALT_X_OFFSET, HALT_Y_OFFSET, HALT_WIDTH, HALT_LIGHT_HEIGHT, True, True, False, False); @@ -410,14 +459,12 @@ draw_halt(struct NEDsim * nedsim) ((HALT_Y_OFFSET+HALT_LIGHT_HEIGHT+HALT_LABEL_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), "HALT", 4); } -// TODO: Explain +// Draw the 32 lights corresponding to 'word' at coordinates ('x','y'). +// Note that this function ONLY draws the lights and is used each frame for +// updating the panel. To draw the wordline area itself, use draw_wordline(). static void draw_wordline_lights(struct NEDsim * nedsim, uint32_t word, int x, int y) { -#define WORDLINE_BITS_PER_STRIPE 4 -#define WORDLINE_WIDTH 32 -#define WORDLINE_HEIGHT 1 - for (int i = 0; i < WORDLINE_WIDTH; i++) { if (word & (1<<(WORDLINE_WIDTH-1-i))) { set_color(nedsim, &color_list[nedsim->color_index].light_on); @@ -428,7 +475,10 @@ draw_wordline_lights(struct NEDsim * nedsim, uint32_t word, int x, int y) } } -// TODO: Explain +// Draw a single 32-bit NED word line at coordinates ('x','y'). +// Note that this draws a wordline with value 0. To update with a specific +// value, call draw_wordline_lights() after drawing the wordline area at least +// once. static void draw_wordline(struct NEDsim * nedsim, int x, int y) { @@ -448,17 +498,10 @@ draw_wordline(struct NEDsim * nedsim, int x, int y) draw_wordline_lights(nedsim, 0, x, y); } -// TODO: Explain +// Draw the Program Counter area (but don't populate it yet). static void draw_pc(struct NEDsim * nedsim) { -// TODO: Note that all #defines use units of 'cells', not 'pixels', etc. -#define PC_X_OFFSET 36 -#define PC_Y_OFFSET 7 -#define PC_WIDTH 32 -#define PC_LABEL_HEIGHT 2 -#define PC_LIGHT_HEIGHT 1 - // First draw the two colored boxes that comprise the PC area. set_color(nedsim, &color_list[nedsim->color_index].tertiary); draw_rect_area(nedsim, PC_X_OFFSET, PC_Y_OFFSET, PC_WIDTH, PC_LABEL_HEIGHT, True, True, False, False); @@ -474,16 +517,10 @@ draw_pc(struct NEDsim * nedsim) ((PC_Y_OFFSET+PC_LABEL_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), "PC", 2); } -// TODO: Explain +// Draw the Stack Counter area (but don't populate it yet). static void draw_sc(struct NEDsim * nedsim) { -#define SC_X_OFFSET 42 -#define SC_Y_OFFSET 2 -#define SC_WIDTH 5 -#define SC_LABEL_HEIGHT 2 -#define SC_LIGHT_HEIGHT 1 - // First draw the two colored boxes that comprise the SC area. set_color(nedsim, &color_list[nedsim->color_index].secondary); draw_rect_area(nedsim, SC_X_OFFSET, SC_Y_OFFSET, SC_WIDTH, SC_LABEL_HEIGHT, True, True, False, False); @@ -500,18 +537,10 @@ draw_sc(struct NEDsim * nedsim) ((SC_Y_OFFSET+SC_LABEL_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), "SC", 2); } -// TODO: Explain +// Draw areas for the two PSW flags, 'Z'ero and 'N'egative. static void draw_psw(struct NEDsim * nedsim) { -#define PSW_N_X_OFFSET 51 -#define PSW_Z_X_OFFSET 58 -#define PSW_Y_OFFSET 2 -#define PSW_LABEL_WIDTH 3 -#define PSW_LABEL_HEIGHT 2 -#define PSW_LIGHT_WIDTH 1 -#define PSW_LIGHT_HEIGHT 1 - // First draw the four colored boxes that comprise the two PSW areas. set_color(nedsim, &color_list[nedsim->color_index].secondary); draw_rect_area(nedsim, PSW_N_X_OFFSET, PSW_Y_OFFSET, PSW_LABEL_WIDTH, PSW_LABEL_HEIGHT, True, True, False, False); @@ -540,16 +569,10 @@ draw_psw(struct NEDsim * nedsim) ((PSW_Y_OFFSET+PSW_LABEL_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), "Z", 1); } -// TODO: Explain +// Draw the stack area (but don't populate it yet). static void draw_stack(struct NEDsim * nedsim) { -#define STACK_X_OFFSET 2 -#define STACK_Y_OFFSET 12 -#define STACK_WIDTH 32 -#define STACK_LABEL_HEIGHT 2 -#define STACK_LIGHT_HEIGHT 1 - // First draw the two colored boxes that comprise the stack area. set_color(nedsim, &color_list[nedsim->color_index].tertiary); draw_rect_area(nedsim, STACK_X_OFFSET, STACK_Y_OFFSET, STACK_WIDTH, STACK_LABEL_HEIGHT, True, True, False, False); @@ -566,15 +589,10 @@ draw_stack(struct NEDsim * nedsim) ((STACK_Y_OFFSET+STACK_LABEL_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), "Stack Size:", 11); } -// TODO: Explain +// Draw the heap area (but don't populate it yet). static void draw_heap(struct NEDsim * nedsim) { -#define HEAP_X_OFFSET 36 -#define HEAP_Y_OFFSET 12 -#define HEAP_WIDTH 32 -#define HEAP_LABEL_HEIGHT 2 -#define HEAP_LIGHT_HEIGHT 1 // TODO: What should I do about this define? I would like to be able to specify the address so I can do things like display the code itself if nothign interesting happens in RAM. #define HEAP_START_ADDRESS 0x20000000 @@ -603,7 +621,9 @@ draw_heap(struct NEDsim * nedsim) ((HEAP_Y_OFFSET+HEAP_LABEL_HEIGHT) * nedsim->cell_size + nedsim->origin_y_offset - local_y_offset), address, strlen(address)); } -// TODO: Explain +// After the static front panel has been drawn at least once, this function +// updates all the dynamic parts of the panel (lights + text values) and is +// called every frame. static void update_display(struct NEDsim * nedsim) { @@ -779,8 +799,8 @@ NEDsim_init(Display * dpy, Window win) int available_space_for_data_rows = nedsim->dpy_height - (nedsim->cell_size * (HEADER_HEIGHT_IN_CELLS + FOOTER_HEIGHT_IN_CELLS)); for (int i = 0; ; i++) { - if ((nedsim->cell_size * (1 << i)) > available_space_for_data_rows) { - nedsim->num_data_rows = (1 << --i); + if ((nedsim->cell_size * i) > available_space_for_data_rows) { + nedsim->num_data_rows = --i; break; } }