new name for OpenScreen?

1
hi all

Chris Chase reported a name conflict between our new "OpenScreen.m"
and a file that he already had. Frans Cornelissen suggested that we
pick a name less likely to conflict with other software.

Okay.

If we do that then we'll also change the name of the companion file,
"CloseScreen.m".

here are candidate names

PsychOpenScreen - seems hard to remember
PsychCloseScreen

PrepareScreen - a more accurate description of what it does
RestoreScreen - "

ConfigureScreen
RestoreScreen

Of these choices - suggestions are welcome - I like PrepareScreen best.

What do you think?

best

denis

p.s.
It's not clear whether users will end up calling these in their
programs or not. SCREEN.mex automatically calls OpenScreen when you
open the first window on a particular screen. But you might want to
call it before opening your first window. OpenScreen in fact does
little or nothing to the screen itself, its main mission is to set up
the parameters (mostly SCREEN Preference values) appropriately for
the particular driver. Thus it is configuring SCREEN.mex not the
screen. CloseScreen does very little. Its mission is to get the
screen back to a usable state, so the user can resume using the
MATLAB Command window. Thus the new names PrepareScreen and
RestoreScreen are much more descriptive of their functions than the
former Open and Close.
2
dear frans

i think that "RestoreScreen" might be what we end up typing when
everything's blitzed and the screen black. at the moment "clear
screen" is better, but i find that
screen(0,'resolution',screen(0,'resolution')) is a very effective way
of restoring the screen and we'll probably put it in RestoreScreen.
So that one should be memorable.

PrepareScreen, as I said, may or may not be something we often call.
Under the current scheme you should call it if you want to do stuff
before opening a window on the screen, which turns out to be a fairly
common thing to do.

thanks.

best

denis

>PrepareScreen sounds fine, .....
>
>however, something is unclear to me: these files are only called by SCREEN
>itself? So, why should they have to be easy to remember? These are files
>few of us will fiddle with anyway, and if we do, it will only be very
>occasionally (unlike moverect, or was it shiftrect or rectshift or.... :-)
>
>Gr.
>
>Frans
>
>
>
>
>
>
>>hi all
>>
>>Chris Chase reported a name conflict between our new "OpenScreen.m"
>>and a file that he already had. Frans Cornelissen suggested that we
>>pick a name less likely to conflict with other software.
>>
>>Okay.
>>
>>If we do that then we'll also change the name of the companion file,
>>"CloseScreen.m".
>>
>>here are candidate names
>>
>>PsychOpenScreen - seems hard to remember
>>PsychCloseScreen
>>
>>PrepareScreen - a more accurate description of what it does
>>RestoreScreen - "
>>
>>ConfigureScreen
>>RestoreScreen
>>
>>Of these choices - suggestions are welcome - I like PrepareScreen best.
>>
>>What do you think?
>>
>>best
>>
>>denis
>>
>>p.s.
>>It's not clear whether users will end up calling these in their
>>programs or not. SCREEN.mex automatically calls OpenScreen when you
>>open the first window on a particular screen. But you might want to
>>call it before opening your first window. OpenScreen in fact does
>>little or nothing to the screen itself, its main mission is to set up
>>the parameters (mostly SCREEN Preference values) appropriately for
>>the particular driver. Thus it is configuring SCREEN.mex not the
>>screen. CloseScreen does very little. Its mission is to get the
>>screen back to a usable state, so the user can resume using the
>>MATLAB Command window. Thus the new names PrepareScreen and
>>RestoreScreen are much more descriptive of their functions than the
>>former Open and Close.
>>
>>
>>http://psychtoolbox.org
>>POST a message to: psychtoolbox@yahoogroups.com
>>UNSUBSCRIBE by sending a blank message to:
>>psychtoolbox-unsubscribe@yahoogroups.com
>>
>>Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/
>
>
>
>http://psychtoolbox.org
>POST a message to: psychtoolbox@yahoogroups.com
>UNSUBSCRIBE by sending a blank message to:
>psychtoolbox-unsubscribe@yahoogroups.com
>
>Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/