jumpscroll.c File Reference

#include <assert.h>
#include <ipxe/keys.h>
#include <ipxe/jumpscroll.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
unsigned int	jump_scroll_key (struct jump_scroller *scroll, int key)
	Jump scrolling. More...
unsigned int	jump_scroll_move (struct jump_scroller *scroll, unsigned int move)
	Move scroller. More...
int	jump_scroll (struct jump_scroller *scroll)
	Jump scroll to new page (if applicable) More...

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

jump_scroll_key()

unsigned int jump_scroll_key	(	struct jump_scroller *	scroll,
		int	key
	)

Jump scrolling.

Handle keypress

Parameters

scroll	Jump scroller
key	Key pressed by user

Return values

move	Scroller movement, or zero

Definition at line 42 of file jumpscroll.c.

                                                                       {
        unsigned int flags = 0;
        int16_t delta;

        /* Sanity checks */
        assert ( scroll->rows != 0 );
        assert ( scroll->count != 0 );
        assert ( scroll->current < scroll->count );
        assert ( scroll->first < scroll->count );
        assert ( scroll->first <= scroll->current );
        assert ( scroll->current < ( scroll->first + scroll->rows ) );

        /* Handle key, if applicable */
        switch ( key ) {
        case KEY_UP:
                delta = -1;
                break;
        case TAB:
                flags = SCROLL_WRAP;
                /* fall through */
        case KEY_DOWN:
                delta = +1;
                break;
        case KEY_PPAGE:
                delta = ( scroll->first - scroll->current - 1 );
                break;
        case KEY_NPAGE:
                delta = ( scroll->first - scroll->current + scroll->rows );
                break;
        case KEY_HOME:
                delta = -( scroll->count );
                break;
        case KEY_END:
                delta = +( scroll->count );
                break;
        default:
                delta = 0;
                break;
        }

        return ( SCROLL ( delta ) | flags );
}

References assert(), jump_scroller::count, jump_scroller::current, jump_scroller::first, flags, key, KEY_DOWN, KEY_END, KEY_HOME, KEY_NPAGE, KEY_PPAGE, KEY_UP, jump_scroller::rows, SCROLL, SCROLL_WRAP, and TAB.

Referenced by form_loop(), main_loop(), and menu_loop().

jump_scroll_move()

unsigned int jump_scroll_move	(	struct jump_scroller *	scroll,
		unsigned int	move
	)

Move scroller.

Parameters

scroll	Jump scroller
move	Scroller movement

Return values

move	Continuing scroller movement (if applicable)

Definition at line 92 of file jumpscroll.c.

                                                    {
        int16_t delta = SCROLL_DELTA ( move );
        int current = scroll->current;
        int last = ( scroll->count - 1 );

        /* Sanity checks */
        assert ( move != 0 );
        assert ( scroll->count != 0 );

        /* Move to the new current item */
        current += delta;

        /* Default to continuing movement in the same direction */
        delta = ( ( delta >= 0 ) ? +1 : -1 );

        /* Check for start/end of list */
        if ( ( current >= 0 ) && ( current <= last ) ) {
                /* We are still within the list.  Update the current
                 * item and continue moving in the same direction (if
                 * applicable).
                 */
                scroll->current = current;
        } else {
                /* We have attempted to move outside the list.  If we
                 * are wrapping around, then continue in the same
                 * direction (if applicable), otherwise reverse.
                 */
                if ( ! ( move & SCROLL_WRAP ) )
                        delta = -delta;

                /* Move to start or end of list as appropriate */
                if ( delta >= 0 ) {
                        scroll->current = 0;
                } else {
                        scroll->current = last;
                }
        }

        return ( SCROLL ( delta ) | ( move & SCROLL_FLAGS ) );
}

References assert(), jump_scroller::count, jump_scroller::current, move(), SCROLL, SCROLL_DELTA, SCROLL_FLAGS, and SCROLL_WRAP.

Referenced by form_loop(), main_loop(), and menu_loop().

jump_scroll()

int jump_scroll

(

struct jump_scroller *

scroll

)

Jump scroll to new page (if applicable)

Parameters

scroll

Jump scroller

Return values

jumped

Jumped to a new page

Definition at line 140 of file jumpscroll.c.

                                                 {
        unsigned int index;

        /* Sanity checks */
        assert ( scroll->rows != 0 );
        assert ( scroll->count != 0 );
        assert ( scroll->current < scroll->count );
        assert ( scroll->first < scroll->count );

        /* Do nothing if we are already on the correct page */
        index = ( scroll->current - scroll->first );
        if ( index < scroll->rows )
                return 0;

        /* Move to required page */
        while ( scroll->first < scroll->current )
                scroll->first += scroll->rows;
        while ( scroll->first > scroll->current )
                scroll->first -= scroll->rows;

        return 1;
}

References assert(), jump_scroller::count, jump_scroller::current, jump_scroller::first, index, and jump_scroller::rows.

Referenced by main_loop(), menu_loop(), and show_menu().