# ChooseRawFile

## Description

Presents the user with an option to choose a file stored on their current platform (Windows/Mac only), for example a photo or sound file. If the user cancels the operation an empty string will be returned, otherwise the file will be copied to the apps current directory and the filename returned so that it can be used by your app.
You may specify an optional extension filter to limit the types of files the user will see when browsing. For example using an extension filter of "*.wav" would limit the user to choosing .wav files. For multiple extensions separate them with a semicolon like so "*.wav;*.mp3;*.png".
If using this command is used in tier 2 the returned string must be deleted when you are finished with it, even if it is an empty string. A null string will not be returned. If you set returnFullPath to 1 then the file will not be copied to the write folder, instead the full path will be returned to you and you can load it using the "raw:" prefix with the normal file commands.

## Definition

string ChooseRawFile( ext )

char* agk::ChooseRawFile( const char* ext )

string ChooseRawFile( ext, returnFullPath )

char* agk::ChooseRawFile( const char* ext, int returnFullPath )

## Parameters

- ext - The extensions to allow
- returnFullPath - 1 to return the full path, 0 to copy it to the write folder and return the write folder path