actions/itgmania212121
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

update docs, cleanup memcardman comments and such

Browse Source
This commit is contained in:
AJ Kelly
2010-03-11 23:48:39 -06:00
parent a059209dcb
commit 0c96a43e98
4 changed files with 122 additions and 78 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Docs/Changelog_sm-ssc.txt
+6
View File
@@ -9,6 +9,12 @@ Not all changes are documented, for various reasons.
supported but exist anyways.)
_____________________________________________________________________________
20100311
--------
* [Player.cpp] Don't add checkpoints to the combo if Autoplay is on.
* Re-add the ability to reload a theme's Lua scripts, this time using Ctrl+F2.
* Convert GrooveRadar base into an AutoActor. (Now it can use a Lua BGAnim.)
20100309
--------
* [ScreenSelectMaster] Add GetSelectionIndex(pn) Lua binding. (You'll have to
Docs/CodingStyle.txt
+40 -3
View File
@@ -8,8 +8,7 @@ That being said, the sm-ssc code style guidelines are as follows:
1) Follow the current coding conventions set forth in the source code.
This means use tabs. AJ prefers tabs have a width of 4. Visual Studio and web
browsers assume tabs to be 8 by default. :/
Use of the tab character means you can define however the fuck wide you want it
to be.
Use of the tab character means you can define however wide you want it to be.
Use of the space character is allowed for complex alignment. There are many
examples of this in the code.
@@ -44,4 +43,42 @@ and Function in [], like so:
LOG->Info( "[NetworkSyncManager::Listen] Initializing socket..." );
You may not always need to do this, but it helps for clarity and sanity.
4) There are no other rules (yet).
4) Comment style. (This is a preferred suggestion. You may choose to do whatever
you like, but it is recommended to follow this style when submitting code for
inclusion.)
// is preferred for one-liners
// and also blocks of text where the comment isn't too long.
// sometimes you'll find // comments longer than this thrown in there by AJ
/* instead of doing this.
* when making a new line in a long form comment, start like this line.
* and put the end where it fits. */
/*
* doing this (first line blank) is discouraged, but is allowed in certain places.
* Copyright notices use this style and should remain doing so; don't clean it up
* in that instance. All new copyright notices should follow this style as well,
* for consistency's sake.
*/
/* use of long comments for one line is VERY discouraged */
// usually, it will will get cleaned up into this style, but there are exceptions:
// exception #1: function arguments
void SomeFunction(size_t /*ACTUAL DATA TYPE*/)
// where you need to have it be /* */ or else it'll mess up.
// exception #2: #defines
#define /* you must use long form in defines, */ \
// otherwise it won't parse the newline correctly (this will cause an error) \
// exception #3: .h files
/* ScreenTypicalExample - this always shows up like this. It usually is always one line, even when it extends past column 80. This is acceptible; Most people don't write novels here like I just did. */
// on comment length:
/* typically total 80 characters is the preferred width per line, like this one.
* Sometimes, you can get away with sentences where a word or phrase hangs over the edge,
* especially if you can guess the context without needing to scroll.
* Pre-existing comments are usually trimmed to meet the 80-column width if they
* go way overboard. */
5) There are no other rules (yet).
src/MemoryCardManager.cpp
+39 -38
View File
@@ -54,19 +54,19 @@ Preference<RString> MemoryCardManager::m_sEditorMemoryCardOsMountPoint( "Editor
const RString MEM_CARD_MOUNT_POINT[NUM_PLAYERS] =
{
/* @ is important; see RageFileManager LoadedDriver::GetPath */
// @ is important; see RageFileManager LoadedDriver::GetPath
"/@mc1/",
"/@mc2/",
};
static const RString MEM_CARD_MOUNT_POINT_INTERNAL[NUM_PLAYERS] =
{
/* @ is important; see RageFileManager LoadedDriver::GetPath */
// @ is important; see RageFileManager LoadedDriver::GetPath
"/@mc1int/",
"/@mc2int/",
};
/* Only access the memory card driver in a timeout-safe thread. */
// Only access the memory card driver in a timeout-safe thread.
class ThreadedMemoryCardWorker: public RageWorkerThread
{
public:
@@ -81,11 +81,11 @@ public:
};
void SetMountThreadState( MountThreadState mts );
/* These functions may time out. */
// These functions may time out.
bool Mount( const UsbStorageDevice *pDevice );
bool Unmount( const UsbStorageDevice *pDevice );
/* This function will not time out. */
// This function will not time out.
bool StorageDevicesChanged( vector<UsbStorageDevice> &aOut );
protected:
@@ -163,10 +163,10 @@ void ThreadedMemoryCardWorker::SetMountThreadState( MountThreadState mts )
{
/* If "pause", stop calling updates in the heartbeat. In principle, we should
* also not return from this function until the current heartbeat, if running,
* finishes. However, since we can't guarantee that it'll exit within the timeout,
* there's no point: we have to return when we time out, and in that case the
* heartbeat will still be running. I don't know if the reasons for pausing
* really need us to wait, so don't. */
* finishes. However, since we can't guarantee that it'll exit within the
* timeout, there's no point: we have to return when we time out, and in that
* case the heartbeat will still be running. I don't know if the reasons for
* pausing really need us to wait, so don't. */
m_MountThreadState = mts;
}
@@ -209,7 +209,7 @@ void ThreadedMemoryCardWorker::DoHeartbeat()
if( m_MountThreadState == paused )
return;
/* If true, detect and mount. If false, only detect. */
// If true, detect and mount. If false, only detect.
bool bMount = (m_MountThreadState == detect_and_mount);
vector<UsbStorageDevice> aStorageDevices;
@@ -227,7 +227,7 @@ bool ThreadedMemoryCardWorker::Mount( const UsbStorageDevice *pDevice )
{
ASSERT( TimeoutEnabled() );
/* If we're currently in a timed-out state, fail. */
// If we're currently in a timed-out state, fail.
if( IsTimedOut() )
return false;
@@ -242,7 +242,7 @@ bool ThreadedMemoryCardWorker::Unmount( const UsbStorageDevice *pDevice )
{
ASSERT( TimeoutEnabled() );
/* If we're currently in a timed-out state, fail. */
// If we're currently in a timed-out state, fail.
if( IsTimedOut() )
return false;
@@ -321,7 +321,7 @@ void MemoryCardManager::Update()
MESSAGEMAN->Broadcast( Message_StorageDevicesChanged );
}
/* Assign cards from m_vStorageDevices to m_Device. */
// Assign cards from m_vStorageDevices to m_Device.
void MemoryCardManager::UpdateAssignments()
{
if( !g_bMemoryCardProfiles.Get() )
@@ -354,18 +354,18 @@ void MemoryCardManager::UpdateAssignments()
UsbStorageDevice &assigned_device = m_Device[p];
if( !assigned_device.IsBlank() )
{
/* The player has a card assigned. If it's been removed, clear it. */
// The player has a card assigned. If it's been removed, clear it.
vector<UsbStorageDevice>::iterator it = find( m_vStorageDevices.begin(), m_vStorageDevices.end(), assigned_device );
if( it != m_vStorageDevices.end() )
{
/* The player has a card, and it's still plugged in. Update any changed
* state, such as m_State. */
/* The player has a card, and it's still plugged in. Update any
* changed state, such as m_State. */
LOG->Trace( "Player %d already has a card: '%s'", p+1, assigned_device.sOsMountDir.c_str() );
assigned_device = *it;
continue;
}
/* The assigned card has been removed; clear it and re-search. */
// The assigned card has been removed; clear it and re-search.
LOG->Trace( "Player %i: disconnected bus %d port %d device %d path %s",
p+1, assigned_device.iBus, assigned_device.iPort, assigned_device.iLevel, assigned_device.sOsMountDir.c_str() );
assigned_device.MakeBlank();
@@ -406,7 +406,7 @@ void MemoryCardManager::UpdateAssignments()
void MemoryCardManager::CheckStateChanges()
{
/* Deal with assignment changes. */
// Deal with assignment changes.
FOREACH_PlayerNumber( p )
{
const UsbStorageDevice &new_device = m_Device[p];
@@ -427,20 +427,21 @@ void MemoryCardManager::CheckStateChanges()
}
else
{
/* We had a card inserted when we finalized. */
// We had a card inserted when we finalized.
if( new_device.m_State == UsbStorageDevice::STATE_NONE )
state = MemoryCardState_Removed;
if( new_device.m_State == UsbStorageDevice::STATE_READY )
{
if( m_FinalDevice[p].sSerial != new_device.sSerial )
{
/* A different card is inserted than we had when we finalized. */
// A different card is inserted than we had when we finalized.
state = MemoryCardState_Error;
sError = "Changed";
}
}
/* Otherwise, the card is checking or has an error. Use the regular logic. */
// Otherwise, the card is checking or has an error.
// Use the regular logic.
}
}
@@ -511,7 +512,7 @@ void MemoryCardManager::WaitForCheckingToComplete()
bool bLogged = false;
while( !g_pWorker->IsTimedOut() )
{
/* Check for changes. */
// Check for changes.
Update();
bool bEitherPlayerIsChecking = false;
@@ -521,8 +522,8 @@ void MemoryCardManager::WaitForCheckingToComplete()
if( !bEitherPlayerIsChecking )
break;
/* Only if we need to, wait for something to happen. If we time out waiting for
* a heartbeat, give up. */
/* Only if we need to, wait for something to happen. If we time out
* waiting for a heartbeat, give up. */
if( !bLogged )
{
bLogged = true;
@@ -550,7 +551,7 @@ void MemoryCardManager::LockCard( PlayerNumber pn )
if( m_bCardLocked[pn] )
return;
/* Set the final state. */
// Set the final state.
CheckStateChanges();
/* If the card in this player's slot is ready, then use it. If there is
@@ -560,7 +561,7 @@ void MemoryCardManager::LockCard( PlayerNumber pn )
else
m_FinalDevice[pn] = UsbStorageDevice();
/* Set this last, since it changes the behavior of CheckStateChanges. */
// Set this last, since it changes the behavior of CheckStateChanges.
m_bCardLocked[pn] = true;
}
@@ -570,11 +571,11 @@ void MemoryCardManager::UnlockCard( PlayerNumber pn )
g_pWorker->SetMountThreadState( ThreadedMemoryCardWorker::detect_and_mount );
/* If a memory card was inserted too late last game, allow it now. */
// If a memory card was inserted too late last game, allow it now.
CheckStateChanges();
}
/* Called just before reading or writing to the memory card. Should block. */
// Called just before reading or writing to the memory card. Should block.
bool MemoryCardManager::MountCard( PlayerNumber pn, int iTimeout )
{
LOG->Trace( "MemoryCardManager::MountCard(%i)", pn );
@@ -582,14 +583,14 @@ bool MemoryCardManager::MountCard( PlayerNumber pn, int iTimeout )
return false;
ASSERT( !m_Device[pn].IsBlank() );
/* Pause the mounting thread when we mount the first drive. */
// Pause the mounting thread when we mount the first drive.
bool bStartingMemoryCardAccess = true;
FOREACH_PlayerNumber( p )
if( m_bMounted[p] )
bStartingMemoryCardAccess = false; /* already did */
bStartingMemoryCardAccess = false; // already did
if( bStartingMemoryCardAccess )
{
/* We're starting to do stuff to the memory cards. */
// We're starting to do stuff to the memory cards.
this->PauseMountingThread( iTimeout );
}
@@ -611,10 +612,10 @@ bool MemoryCardManager::MountCard( PlayerNumber pn, int iTimeout )
return true;
}
/* We don't want to unmount the timeout FS. Instead, just move the target. */
// We don't want to unmount the timeout FS. Instead, just move the target.
pDriver->Remount( m_Device[pn].sOsMountDir );
/* Flush mountpoints pointing to what we've mounted. */
// Flush mountpoints pointing to what we've mounted.
FILEMAN->FlushDirCache( MEM_CARD_MOUNT_POINT[pn] );
FILEMAN->FlushDirCache( MEM_CARD_MOUNT_POINT_INTERNAL[pn] );
@@ -643,16 +644,16 @@ void MemoryCardManager::UnmountCard( PlayerNumber pn )
if( !m_bMounted[pn] )
return;
/* Leave our own filesystem drivers mounted. Unmount the kernel mount. */
// Leave our own filesystem drivers mounted. Unmount the kernel mount.
g_pWorker->Unmount( &m_Device[pn] );
/* Flush mountpoints pointing to what we've unmounted. */
// Flush mountpoints pointing to what we've unmounted.
FILEMAN->FlushDirCache( MEM_CARD_MOUNT_POINT[pn] );
FILEMAN->FlushDirCache( MEM_CARD_MOUNT_POINT_INTERNAL[pn] );
m_bMounted[pn] = false;
/* Unpause the mounting thread when we unmount the last drive. */
// Unpause the mounting thread when we unmount the last drive.
bool bNeedUnpause = true;
FOREACH_PlayerNumber( p )
if( m_bMounted[p] )
@@ -693,7 +694,7 @@ void MemoryCardManager::PauseMountingThread( int iTimeout )
g_pWorker->SetMountThreadState( ThreadedMemoryCardWorker::paused );
/* Start the timeout period. */
// Start the timeout period.
g_pWorker->SetTimeout( (float) iTimeout );
RageFileDriverTimeout::SetTimeout( (float) iTimeout );
}
@@ -704,7 +705,7 @@ void MemoryCardManager::UnPauseMountingThread()
g_pWorker->SetMountThreadState( ThreadedMemoryCardWorker::detect_and_mount );
/* End the timeout period. */
// End the timeout period.
g_pWorker->SetTimeout( -1 );
RageFileDriverTimeout::SetTimeout( -1 );
}
src/MemoryCardManager.h
+1 -1
View File
@@ -31,7 +31,7 @@ public:
bool IsMounted( PlayerNumber pn ) const { return m_bMounted[pn]; }
/* When paused, no changes in memory card state will be noticed until unpaused. */
// When paused, no changes in memory card state will be noticed until unpaused.
void PauseMountingThread( int iTimeout = 20 );
void UnPauseMountingThread();