Using function without variable GOOD or BAD ?

[tonycst]

Help file says:

If a handle is returned, it must be released using _WinAPI_DeleteObject().

and gives example:

_ScreenCapture_Capture(@MyDocumentsDir & "\GDIPlus_Image1.jpg")

which makes no sense because there is no variable for the function and if you look at the complete example code, there is no _WinAPI_DeleteObject(). either.

Does that mean that if no variable is used to call one or another function, there is no need to worry about memory leaks ? (or clutter)

Related question: Does memory get cleared of all data once script exists  or it need to be cleared ?

 

thank ya

[BrewManNH]

Your 1st question doesn't make a lot of sense. If you use _ScreenCapture_Capture with a file name as the first parameter, then you won't get a handle returned, you get True if the image is saved ok.

No where does it say if you use a variable that you need to use _WinAPI_DeleteObject.

You're asking too broad a question and using a single function as an example for the question to which it doesn't apply to at all.

Most of the time when the script closes it clears its data, but not always in some cases, so it's best to clear them yourself prior to exiting.

[mikell]

11 hours ago, tonycst said:

which makes no sense because there is no variable for the function and if you look at the complete example code, there is no _WinAPI_DeleteObject(). either.

Using _ScreenCapture_Capture() depending on the first param you get : either a handle (and then you must be release it using _WinAPI_DeleteObject ) or a file (and then the used variables are released internally by the UDF )

[tonycst]

Oh ok i get it now.

I thought variable before _ScreenCapture_Capture is the handle.

I guess variable is a handle storage ?

Does that mean i should not use _ScreenCapture_Capture(@DesktopDir & "\Shapshot.jpg") without variable so that i can delete the object once picture is saved, correct ?

Thanks

[spudw2k]

Per the help file:
 

Return Value

Returns a handle to an HBITMAP if $sFileName is empty.
    If called with $sFileName then the image is saved to the file and nothing is returned.

Remarks

If a handle is returned, it must be released using _WinAPI_DeleteObject().

 

So, if you do specify a filename to output the image to, nothing gets returned.  
If you don't specify a filename, an HBITMAP object handle is returned and therefore should be released when finished with using _WinAPI_DeleteObject

 

 

If you look at the ScreenCapture.au3 UDF, you'll see at the end of the _ScreenCapture_Capture() function it evaluates if $sFilename = "".

• If $sFileName = "" Then Return handle else 
• Continue script and provide the bitmap object as a parameter to the _ScreenCapture_SaveImage and set $bFreeBmp paramter to true (which executes _WinAPI_DeleteObject after saving the file).

So either way, with cleanup is (should be) done.

[tonycst]

one day ill understand all of what you said.

thanks !

[spudw2k]

Let me take a small step back to make sure something fundamental is understood;  what is meant by a return?

When you execute a function, it typically "returns" something (i.e. value, string, array, etc.).  The variable placed in front of a function--i.e. $iMsg = Msgbox(...)--will be assigned what the function returns. 

Now, after that..does re-reading my post above help explain any better?

[tonycst]

i got that part yes.