Artifact 01094c221c512e35b594754f5e592a0bc06d953e14f0d40a45a256eaad254e9c:

• File etc/transformer/location.tcl — part of check-in [2cbec910b5] at 2023-03-26 19:22:15 on branch trunk — rework: dsl reader/writer changes, operator signatures and use chore: updated testsuite feat: converted (some) parameters of select, crop, embed, upsample, threshold, and mask operators to optional. - dsl reader : `(tcl-)operater` unified, only operator. - dsl reader : `arguments` removed, all done through regular parameters and inputs. - dsl reader : new `external!`, describe operators not implemented through dsl yet placed into the hierarchy. - dsl writer : most operators now have a Tcl wrapper handling parameters (required, optional). - dsl writer : operator signature change : parameters, even required, as args key/value series after inputs (if any). - dsl writer : exception: non-image result without simplifications, no images or parameters -> no wrapper, and no args key/value series for parameters, regular in-order command arguments instead. (see point and rectangle operators) (user: aku size: 3609)

## -*- mode: tcl ; fill-column: 90 -*-
# # ## ### ##### ######## ############# #####################
## Transformers -- Location changes

# # ## ### ##### ######## ############# #####################

operator op::location::move::to {
    section transform location

    note Returns image translationally shifted along the x- and y-axes to a specific location

    input

    int x  New absolute x location of image in the plane
    int y  New absolute y location of image in the plane

    # Elide the operation if the input is already at the desired location
    simplify for \
	src/attr x __x \
	src/attr y __y \
	if {($x == $__x) && ($y == $__y)} \
	returns src

    # Chain reduction when input is a translation of any kind as well.
    # The new location supercedes the previous movement.
    # This may cause full elision in the recursion.

    simplify for src/type @self \
	src/pop \
	returns op location move to : x x y y

    simplify for src/type op::location::move::by \
	src/pop \
	returns op location move to : x x y y

    state -fields {
	aktive_point delta;
    } -setup {
	// geometry setup
	// - get input geometry in local store
	// - compute and save difference to desired location
	// - update local store for desired location

	aktive_geometry_copy (domain, aktive_image_get_geometry (srcs->v[0]));

	aktive_uint dx = domain->x - param->x;
	aktive_uint dy = domain->y - param->y;
	aktive_point_set (&state->delta, dx, dy);

	aktive_point_set (aktive_geometry_as_point(domain), param->x, param->y);
    }
    pixels {
	// rewrite request for passing to input, translate to the origin location
	// fetch data, and save to local store

	aktive_rectangle_def_as (subrequest, request);
	aktive_rectangle_add    (&subrequest, &istate->delta);

	aktive_block* src = aktive_region_fetch_area (srcs->v[0], &subrequest);
	aktive_blit_copy0 (block, dst, src);
    }
}

operator op::location::move::by {
    section transform location

    note Returns image translationally shifted along the x- and y-axes by a specific amount

    input

    int dx  Shift amount for x location of image in the plane, positive to the right, negative left
    int dy  Shift amount for y location of image in the plane, positive downward, negative upward

    # Elide the operation if there is no actual shift
    simplify for   if {($dx == 0) && ($dy == 0)}   returns src

    # Chain reduction when input is a translation of any kind as well.
    # The preceding movement is folded into the current.
    # This may cause full elision in the recursion

    simplify for src/type @self \
	src/value dx __dx src/value dy __dy \
	calc __ndx {$__dx + $dx} \
	calc __ndy {$__dy + $dy} \
	src/pop \
	returns op location move by : dx __ndx dy __ndy

    simplify for src/type op::location::move::to \
	src/value x __x src/value y __y \
	calc __nx {$__x + $dx} \
	calc __ny {$__y + $dy} \
	src/pop \
	returns op location move to : x __nx y __ny

    state -fields {
	aktive_point delta;
    } -setup {
	aktive_geometry_copy (domain, aktive_image_get_geometry (srcs->v[0]));
	aktive_point_set (&state->delta, - param->dx, - param->dy);

	domain->x += param->dx;
	domain->y += param->dy;
    }
    pixels {
	// rewrite request for passing to input, translate to the origin location
	// fetch data, and save to local store

	aktive_rectangle_def_as (subrequest, request);
	aktive_rectangle_add    (&subrequest, &istate->delta);

	aktive_block* src = aktive_region_fetch_area (srcs->v[0], &subrequest);
	aktive_blit_copy0 (block, dst, src);
    }
}

##
# # ## ### ##### ######## ############# #####################
::return