Publish VCC Plus OSS source distribution for 3.6.2 build 60
This commit is contained in:
commit
c652a5276d
1192 files changed
+272368
No files matched your search
@@ -0,0 +1,298 @@
|
||||
//#define USE_LOGGING
|
||||
//======================================================================
|
||||
// This file is part of VCC (Virtual Color Computer).
|
||||
// Vcc is Copyright 2015 by Joseph Forgione
|
||||
//
|
||||
// VCC (Virtual Color Computer) is free software, you can redistribute
|
||||
// and/or modify it under the terms of the GNU General Public License
|
||||
// as published by the Free Software Foundation, either version 3 of
|
||||
// the License, or (at your option) any later version.
|
||||
//
|
||||
// VCC (Virtual Color Computer) is distributed in the hope that it will
|
||||
// be useful, but WITHOUT ANY WARRANTY; without even the implied
|
||||
// warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
||||
// See the GNU General Public License for more details.
|
||||
//
|
||||
// You should have received a copy of the GNU General Public License
|
||||
// along with VCC (Virtual Color Computer). If not, see
|
||||
// <http://www.gnu.org/licenses/>.
|
||||
//======================================================================
|
||||
//
|
||||
// Command line arguments and options to VCC
|
||||
// E J Jaquay 2020
|
||||
//
|
||||
// Since VCC is a windows application traditional Unix command arguments (argc,argV)
|
||||
// are not availiable. However the third argument to WinMain() does provide the
|
||||
// command string less the program name. Historically this argument is used
|
||||
// to supply the path of a Color Computer image file that is loaded into memory
|
||||
// after VCC starts.
|
||||
//
|
||||
// This program permits the command string to supply other information to VCC when
|
||||
// it starts up. It allows the specification of differing VCC init files.
|
||||
//
|
||||
// When writing this I tried to make as flexible as possible as possible without
|
||||
// adding any new dependancies to VCC. By making simple changes to this file
|
||||
// and to the functions that use them it should be possible to add other things.
|
||||
// It maybe. however, that the ability to specify the vcc config file and
|
||||
// possibly logging options will be sufficent for most.
|
||||
//
|
||||
// Syntax:
|
||||
//
|
||||
// Items on command string are separated by blanks unless within quotes.
|
||||
//
|
||||
// Options are specified by a leading dash "-" followed by a single character
|
||||
// option code. This may be followed by an option value.
|
||||
//
|
||||
// Anything that is not an option is considered to be a positional argument.
|
||||
// It is intended that the legacy image file path name will remain the first
|
||||
// such argument so that existing usage is not affected. If there is no longer
|
||||
// a need to specify an image file on the command line this could change.
|
||||
//
|
||||
// Examples:
|
||||
//
|
||||
// Specify the config file fred wants to use:
|
||||
// $ VCC -i C:\users\fred\my-vcc.ini
|
||||
//
|
||||
// Inifile in VCC appdir:
|
||||
// $ VCC -i %APPDIR%/vcc/my-vcc.ini
|
||||
//
|
||||
// In current working directory:
|
||||
// $ VCC -i my-vcc.ini
|
||||
//
|
||||
// Quick load image file:
|
||||
// $ VCC "C:\barney's good image.ima"
|
||||
//
|
||||
// Auto paste text:
|
||||
// $ VCC -p "drive 3: loadm "sigmon6": exec"
|
||||
//
|
||||
// Errors returned:
|
||||
// CL_ERR_UNKOPT Unknown option found
|
||||
// CL_ERR_XTRARG Too many arguments
|
||||
//
|
||||
// Caveauts:
|
||||
//
|
||||
// o Supports short (single char) option codes only.
|
||||
// o Option codes may not be combined. Each must be preceeded by dash: '-'
|
||||
// o Command string cannot be longer than 255 characters.
|
||||
// o Wide character or control character input is not supported.
|
||||
// o No provision to escape double quotes or other special characters.
|
||||
//-------------------------------------------------------------------
|
||||
|
||||
#include <stdlib.h>
|
||||
#include <stdio.h>
|
||||
#include <string.h>
|
||||
#include "../../src/core/BuildConfig.h"
|
||||
#include "CommandLine.h"
|
||||
#include <vcc/util/logger.h>
|
||||
|
||||
// Define global command line settings
|
||||
struct CmdLineArguments CmdArg;
|
||||
|
||||
constexpr auto SEPMARK = 3u; //To mark spaces as separators
|
||||
|
||||
char *ParseCmdString(const char *, const char *);
|
||||
char *GetNextToken ();
|
||||
static char *NxtTokenPtr;
|
||||
|
||||
//-------------------------------------------------------------------
|
||||
// Parse the VCC command string and set ConfigFile, QuickLoadFile, and
|
||||
// possibly other things. Variables set by this routine are global and
|
||||
// are defined in CommandLine.h
|
||||
//
|
||||
// vcc.exe [-d[level]] [-p text] [-i ConfigFile] [QuickLoadFile]
|
||||
//
|
||||
// CmdString: The third arg to WinMain()
|
||||
//-------------------------------------------------------------------
|
||||
|
||||
int GetCmdLineArgs(const char *CmdString)
|
||||
{
|
||||
const char *token; // token pointer (to item in command string)
|
||||
int argnum = 0; // non-option argument number
|
||||
int len; // len of a chr string
|
||||
|
||||
// Options that require values need to be known by the parser
|
||||
// to allow seperation between option code and value.
|
||||
// -i and -p both require options
|
||||
static const char * ValueRequired = "ip";
|
||||
|
||||
// Initialize the global variables set by this routine
|
||||
memset(&CmdArg,0,sizeof(CmdArg));
|
||||
|
||||
// Get the first token from the command string
|
||||
token = ParseCmdString(CmdString,ValueRequired);
|
||||
while (token) {
|
||||
|
||||
// Option?
|
||||
if (*token == '-') {
|
||||
switch (*(token+1)) {
|
||||
|
||||
// "-i" specfies the Vcc configuration file to use.
|
||||
// The value is required and will be found starting
|
||||
// at the third character of the option string.
|
||||
// Default config file is "vcc.ini"
|
||||
case 'i':
|
||||
strncpy(CmdArg.IniFile,token+2,CL_MAX_PATH-1);
|
||||
len = strlen(CmdArg.IniFile);
|
||||
CmdArg.IniFile[len] = '\0';
|
||||
break;
|
||||
|
||||
#if USE_DEBUG_OPTIONS
|
||||
// "-n" render no output at all for running in batch mode.
|
||||
case 'n':
|
||||
CmdArg.NoOutput = true;
|
||||
break;
|
||||
|
||||
// "-f<n> render <n> frames and then exit.
|
||||
case 'f':
|
||||
CmdArg.MaxFrames = atoi(token + 2);
|
||||
break;
|
||||
|
||||
// "-s<file> dump screen shot prior to exit of -f option.
|
||||
case 's':
|
||||
strncpy(CmdArg.Screenshot, token + 2, sizeof(CmdArg.Screenshot) - 1);
|
||||
CmdArg.Screenshot[sizeof(CmdArg.Screenshot) - 1] = 0;
|
||||
break;
|
||||
#endif
|
||||
|
||||
// "-d[level]" enables logging console and sets log level
|
||||
// level is optional. It defaults to 1 and is forced to be
|
||||
// a positive integer 0 to 3.
|
||||
case 'd':
|
||||
if (*(token+2)) {
|
||||
CmdArg.Logging = atoi(token+2);
|
||||
if (CmdArg.Logging < 1) CmdArg.Logging = 0;
|
||||
if (CmdArg.Logging > 3) CmdArg.Logging = 3;
|
||||
} else {
|
||||
CmdArg.Logging = 1;
|
||||
}
|
||||
break;
|
||||
|
||||
// "-p text" Auto paste text on startup. '\n' is appended
|
||||
case 'p':
|
||||
strncpy(CmdArg.PasteText,token+2,CL_MAX_PASTE-2);
|
||||
len = strlen(CmdArg.PasteText);
|
||||
CmdArg.PasteText[len] = '\n';
|
||||
CmdArg.PasteText[len+1] = 0;
|
||||
break;
|
||||
|
||||
// Unknown option code returns an error
|
||||
default:
|
||||
return CL_ERR_UNKOPT;
|
||||
}
|
||||
|
||||
// else Positional argument
|
||||
// argnum indicates argument position starting at one.
|
||||
} else {
|
||||
switch (++argnum) {
|
||||
|
||||
// First (currently only) positional arg is Quick Load filename.
|
||||
case 1:
|
||||
strncpy(CmdArg.QLoadFile,token,CL_MAX_PATH);
|
||||
CmdArg.QLoadFile[CL_MAX_PATH-1]=0;
|
||||
break;
|
||||
|
||||
// Extra positional argument returns an error
|
||||
default:
|
||||
return CL_ERR_XTRARG;
|
||||
}
|
||||
}
|
||||
|
||||
// Get next token
|
||||
token = ParseCmdString(nullptr,ValueRequired);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
//-------------------------------------------------------------------
|
||||
// Command string parser.
|
||||
//
|
||||
// Input string is tokenized using one or more blanks as a separator, excepting
|
||||
// blanks within quotes. If the input String is not null a pointer to the
|
||||
// first token is returned. Otherwise pointers to subsequent tokens are returned.
|
||||
// When there are no more tokens a null pointer is returned.
|
||||
//
|
||||
// ValueRequired: String containing option codes that require values.
|
||||
//
|
||||
//-------------------------------------------------------------------
|
||||
|
||||
char * ParseCmdString(const char *CmdString, const char *ValueRequired)
|
||||
{
|
||||
static char cmdline[512]; // Copy of cmd string
|
||||
static char option[256]; // Used to append value to option
|
||||
int quoted;
|
||||
char *token;
|
||||
const char *value;
|
||||
|
||||
// Initial call sets command string. Subsequent calls expect a NULL
|
||||
if (CmdString) {
|
||||
while (*CmdString == ' ') CmdString++; // Skip leading blanks
|
||||
strncpy(cmdline,CmdString,512); // Make a copy of what is left
|
||||
strcat(cmdline," "); // Make sure args are terminated
|
||||
cmdline[511]='\0'; // Be sure string is terminated
|
||||
NxtTokenPtr = cmdline; // Save it's location
|
||||
|
||||
// Mark unquoted blanks
|
||||
quoted = 0;
|
||||
for( char * p = NxtTokenPtr; *p; p++) {
|
||||
if (*p == '"') {
|
||||
quoted = !quoted;
|
||||
} else if (!quoted) {
|
||||
if (*p == ' ') *p = SEPMARK;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (token = GetNextToken()) {
|
||||
// Check if it is an option token. If a option value is
|
||||
// required and value is seperated make a copy and append
|
||||
// next token to it
|
||||
if ((token[0] == '-') && (token[1] != '\0') && (token[2] == '\0')) {
|
||||
if (strchr(ValueRequired,token[1])) {
|
||||
if ((NxtTokenPtr[0] != '\0') && (NxtTokenPtr[0] != '-')) {
|
||||
if (value = GetNextToken()) {
|
||||
strcpy(option,token);
|
||||
strcat(option,value);
|
||||
return option;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
return token; // null, positional argument, or option with no value
|
||||
}
|
||||
|
||||
//-------------------------------------------------------------------
|
||||
// Terminate token, find next token, return pointer to current
|
||||
//-------------------------------------------------------------------
|
||||
|
||||
char *GetNextToken ()
|
||||
{
|
||||
// Return NULL if no tokens
|
||||
if (*NxtTokenPtr == '\0') return nullptr;
|
||||
|
||||
// Save token pointer
|
||||
char *token = NxtTokenPtr++;
|
||||
|
||||
// Advance to end of token
|
||||
while (*NxtTokenPtr != SEPMARK) NxtTokenPtr++;
|
||||
|
||||
// If anything remains
|
||||
if (*NxtTokenPtr != '\0') {
|
||||
|
||||
// Terminate current token
|
||||
*NxtTokenPtr++ = '\0';
|
||||
|
||||
// Skip past extra separaters to start of next
|
||||
while (*NxtTokenPtr == SEPMARK) NxtTokenPtr++;
|
||||
}
|
||||
|
||||
//Strip leading and trailing quotes from token
|
||||
if (token[0] == '"') {
|
||||
token++;
|
||||
int n = strlen(token);
|
||||
if ((n > 0) && (token[n-1] == '"')) token[n-1] = '\0';
|
||||
}
|
||||
|
||||
// Return address of current token
|
||||
return token;
|
||||
}
|
||||
Reference in new issue
Block a user