NAME

image_resize_storage - resize the dimensions of the image backing store

SYNOPSIS

nil
image_resize_storage( vid:tgt, int:neww, int:newh )
image_resize_storage( vid:tgt, int:neww, int:newh, int:vieww, int:viewh, int:viewx, int:viewy )

DESCRIPTION

This function is indended for testing streaming transfers and for rendertargets where one may need to permanently or temporarily change backing storage dimensions in order to save memory or deal with rendertarget resize without rebuilding attachment chains. The longer argument form with vieww , viewh , viewx and viewy redefines the window coordinate system range from 0,0,neww,newh to viewx,viewy,viewx+vieww,viewy+viewh. This can be used together with define_linktarget in order to have two different views of the same pipeline.

NOTES

1

There is no guarantee that the change can be performed as some platforms may impose alignment and padding requirements.

2

The underlying code-path is similar to the resized event for a frameserver, but without the event being emitted. No alert is raised if the change could not be performed due to video hardware issues or memory constraints.

EXAMPLE

function image_resize_storage0()


      local surf = alloc_surface(640, 480);


      local props = image_storage_properties(surf);


      print(props.width, props.height);


      image_resize_storage(surf, 320, 240);


      props = image_storage_properties(surf);


      print(props.width, props.height);
end

SEE ALSO: