guiBitmapButtonCtrl.cpp 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671
  1. //-----------------------------------------------------------------------------
  2. // Copyright (c) 2012 GarageGames, LLC
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to
  6. // deal in the Software without restriction, including without limitation the
  7. // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  8. // sell copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  19. // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  20. // IN THE SOFTWARE.
  21. //-----------------------------------------------------------------------------
  22. #include "platform/platform.h"
  23. #include "gui/buttons/guiBitmapButtonCtrl.h"
  24. #include "core/util/path.h"
  25. #include "console/console.h"
  26. #include "console/consoleTypes.h"
  27. #include "console/engineAPI.h"
  28. #include "gui/core/guiCanvas.h"
  29. #include "gui/core/guiDefaultControlRender.h"
  30. #include "gfx/gfxDrawUtil.h"
  31. #include "gfx/gfxTextureManager.h"
  32. #include "gui/editor/inspector/group.h"
  33. #include "gui/editor/inspector/field.h"
  34. #include "gui/editor/guiInspector.h"
  35. ImplementEnumType( GuiBitmapMode,
  36. "Rendering behavior when placing bitmaps in controls.\n\n"
  37. "@ingroup GuiImages" )
  38. { GuiBitmapButtonCtrl::BitmapStretched, "Stretched", "Stretch bitmap to fit control extents." },
  39. { GuiBitmapButtonCtrl::BitmapCentered, "Centered", "Center bitmap in control." },
  40. EndImplementEnumType;
  41. //=============================================================================
  42. // GuiBitmapButtonCtrl
  43. //=============================================================================
  44. IMPLEMENT_CONOBJECT(GuiBitmapButtonCtrl);
  45. ConsoleDocClass( GuiBitmapButtonCtrl,
  46. "@brief A button that renders its various states (mouse over, pushed, etc.) from separate bitmaps.\n\n"
  47. "A bitmapped button is a push button that uses one or more texture images for rendering its individual states.\n\n"
  48. "To find the individual textures associated with the button, a naming scheme is used. For each state "
  49. "a suffix is appended to the texture file name given in the GuiBitmapButtonCtrl::bitmap field:\n"
  50. "- \"_n\": Normal state. This one will be active when no other state applies.\n"
  51. "- \"_h\": Highlighted state. This applies when the mouse is hovering over the button.\n"
  52. "- \"_d\": Depressed state. This applies when the left mouse button has been clicked on the button but not yet released.\n"
  53. "- \"_i\": Inactive state. This applies when the button control has been deactivated (GuiControl::setActive())\n\n"
  54. "If a bitmap for a particular state cannot be found, the default bitmap will be used. To disable all state-based "
  55. "bitmap functionality, set useStates to false which will make the control solely render from the bitmap specified "
  56. "in the bitmap field.\n\n"
  57. "@section guibitmapbutton_modifiers Per-Modifier Button Actions\n"
  58. "If GuiBitmapButtonCtrl::useModifiers is set to true, per-modifier button actions and textures are enabled. This functionality "
  59. "allows to associate different images and different actions with a button depending on which modifiers are pressed "
  60. "on the keyboard by the user.\n\n"
  61. "When enabled, this functionality alters the texture lookup above by prepending the following strings to the "
  62. "suffixes listed above:\n"
  63. "- \"\": Default. No modifier is pressed.\n"
  64. "- \"_ctrl\": Image to use when CTRL/CMD is down.\n"
  65. "- \"_alt\": Image to use when ALT is down.\n"
  66. "- \"_shift\": Image to use when SHIFT is down\n\n"
  67. "When this functionality is enabled, a new set of callbacks is used:\n"
  68. "- onDefaultClick: Button was clicked without a modifier being presssed.\n"
  69. "- onCtrlClick: Button was clicked with the CTRL/CMD key down.\n"
  70. "- onAltClick: Button was clicked with the ALT key down.\n"
  71. "- onShiftClick: Button was clicked with the SHIFT key down.\n\n"
  72. "GuiControl::command or GuiControl::onAction() still work as before when per-modifier functionality is enabled.\n\n"
  73. "Note that modifiers cannot be mixed. If two or more modifiers are pressed, a single one will take precedence over "
  74. "the remaining modifiers. The order of precedence corresponds to the order listed above.\n\n"
  75. "@tsexample\n"
  76. "// Create an OK button that will trigger an onOk() call on its parent when clicked:\n"
  77. "%okButton = new GuiBitmapButtonCtrl()\n"
  78. "{\n"
  79. " bitmap = \"art/gui/okButton\";\n"
  80. " autoFitExtents = true;\n"
  81. " command = \"$ThisControl.getParent().onOk();\";\n"
  82. "};\n"
  83. "@endtsexample\n\n"
  84. "@ingroup GuiButtons"
  85. );
  86. IMPLEMENT_CALLBACK( GuiBitmapButtonCtrl, onDefaultClick, void, (), (),
  87. "Called when per-modifier functionality is enabled and the user clicks on the button without any modifier pressed.\n"
  88. "@ref guibitmapbutton_modifiers" );
  89. IMPLEMENT_CALLBACK( GuiBitmapButtonCtrl, onCtrlClick, void, (), (),
  90. "Called when per-modifier functionality is enabled and the user clicks on the button with the CTRL key pressed.\n"
  91. "@ref guibitmapbutton_modifiers" );
  92. IMPLEMENT_CALLBACK( GuiBitmapButtonCtrl, onAltClick, void, (), (),
  93. "Called when per-modifier functionality is enabled and the user clicks on the button with the ALT key pressed.\n"
  94. "@ref guibitmapbutton_modifiers" );
  95. IMPLEMENT_CALLBACK( GuiBitmapButtonCtrl, onShiftClick, void, (), (),
  96. "Called when per-modifier functionality is enabled and the user clicks on the button with the SHIFT key pressed.\n"
  97. "@ref guibitmapbutton_modifiers" );
  98. //-----------------------------------------------------------------------------
  99. GuiBitmapButtonCtrl::GuiBitmapButtonCtrl()
  100. {
  101. mBitmapMode = BitmapStretched;
  102. mAutoFitExtents = false;
  103. mUseModifiers = false;
  104. mUseStates = true;
  105. setExtent( 140, 30 );
  106. mMasked = false;
  107. INIT_ASSET(Bitmap);
  108. }
  109. //-----------------------------------------------------------------------------
  110. void GuiBitmapButtonCtrl::initPersistFields()
  111. {
  112. addGroup( "Bitmap" );
  113. INITPERSISTFIELD_IMAGEASSET(Bitmap, GuiBitmapButtonCtrl, "Texture file to display on this button.\n"
  114. "If useStates is false, this will be the file that renders on the control. Otherwise, this will "
  115. "specify the default texture name to which the various state and modifier suffixes are appended "
  116. "to find the per-state and per-modifier (if enabled) textures.");
  117. addField( "bitmapMode", TYPEID< BitmapMode >(), Offset( mBitmapMode, GuiBitmapButtonCtrl ),
  118. "Behavior for fitting the bitmap to the control extents.\n"
  119. "If set to 'Stretched', the bitmap will be stretched both verticall and horizontally to fit inside "
  120. "the control's extents.\n\n"
  121. "If set to 'Centered', the bitmap will stay at its original resolution centered in the control's "
  122. "rectangle (getting clipped if the control is smaller than the texture)." );
  123. addProtectedField( "autoFitExtents", TypeBool, Offset( mAutoFitExtents, GuiBitmapButtonCtrl ),
  124. &_setAutoFitExtents, &defaultProtectedGetFn,
  125. "If true, the control's extents will be set to match the bitmap's extents when setting the bitmap.\n"
  126. "The bitmap extents will always be taken from the default/normal bitmap (in case the extents of the various "
  127. "bitmaps do not match up.)" );
  128. addField( "useModifiers", TypeBool, Offset( mUseModifiers, GuiBitmapButtonCtrl ),
  129. "If true, per-modifier button functionality is enabled.\n"
  130. "@ref guibitmapbutton_modifiers" );
  131. addField( "useStates", TypeBool, Offset( mUseStates, GuiBitmapButtonCtrl ),
  132. "If true, per-mouse state button functionality is enabled.\n"
  133. "Defaults to true.\n\n"
  134. "If you do not use per-state images on this button set this to false to speed up the loading process "
  135. "by inhibiting searches for the individual images." );
  136. addField("masked", TypeBool, Offset(mMasked, GuiBitmapButtonCtrl),"Use alpha masking for interaction.");
  137. endGroup( "Bitmap" );
  138. Parent::initPersistFields();
  139. }
  140. //-----------------------------------------------------------------------------
  141. bool GuiBitmapButtonCtrl::onWake()
  142. {
  143. if (! Parent::onWake())
  144. return false;
  145. setActive( true );
  146. setBitmap( getBitmap() );
  147. return true;
  148. }
  149. //-----------------------------------------------------------------------------
  150. void GuiBitmapButtonCtrl::onSleep()
  151. {
  152. if( dStricmp(mBitmapName, "texhandle") != 0 )
  153. for( U32 i = 0; i < NumModifiers; ++ i )
  154. {
  155. mTextures[ i ].mTextureNormal = NULL;
  156. mTextures[ i ].mTextureHilight = NULL;
  157. mTextures[ i ].mTextureDepressed = NULL;
  158. mTextures[ i ].mTextureInactive = NULL;
  159. }
  160. Parent::onSleep();
  161. }
  162. //-----------------------------------------------------------------------------
  163. bool GuiBitmapButtonCtrl::_setAutoFitExtents( void *object, const char *index, const char *data )
  164. {
  165. GuiBitmapButtonCtrl* ctrl = reinterpret_cast< GuiBitmapButtonCtrl* >( object );
  166. ctrl->setAutoFitExtents( dAtob( data ) );
  167. return false;
  168. }
  169. //-----------------------------------------------------------------------------
  170. /*bool GuiBitmapButtonCtrl::_setBitmap(void* object, const char* index, const char* data)
  171. {
  172. GuiBitmapButtonCtrl* ctrl = reinterpret_cast< GuiBitmapButtonCtrl* >( object );
  173. ctrl->setBitmap( StringTable->insert(data) );
  174. return false;
  175. }*/
  176. //-----------------------------------------------------------------------------
  177. // Legacy method. Can just assign to bitmap field.
  178. /*DefineEngineMethod(GuiBitmapButtonCtrl, setBitmap, void, (const char* path), ,
  179. "Set the bitmap to show on the button.\n"
  180. "@param path Path to the texture file in any of the supported formats.\n" )
  181. {
  182. object->setBitmap( StringTable->insert(path) );
  183. }*/
  184. //-----------------------------------------------------------------------------
  185. void GuiBitmapButtonCtrl::inspectPostApply()
  186. {
  187. Parent::inspectPostApply();
  188. Torque::Path path( mBitmapName );
  189. const String& fileName = path.getFileName();
  190. if( mUseStates )
  191. {
  192. // If the filename points to a single state, automatically
  193. // cut off the state part. Makes it easy to select files in
  194. // the editor without having to go in and manually cut off the
  195. // state parts all the time.
  196. static String s_n = "_n";
  197. static String s_d = "_d";
  198. static String s_h = "_h";
  199. static String s_i = "_i";
  200. if( fileName.endsWith( s_n )
  201. || fileName.endsWith( s_d )
  202. || fileName.endsWith( s_h )
  203. || fileName.endsWith( s_i ) )
  204. {
  205. path.setFileName( fileName.substr( 0, fileName.length() - 2 ) );
  206. path.setExtension( String::EmptyString );
  207. }
  208. }
  209. setBitmap( StringTable->insert(path.getFullPath().c_str()) );
  210. // if the extent is set to (0,0) in the gui editor and appy hit, this control will
  211. // set it's extent to be exactly the size of the normal bitmap (if present)
  212. if ((getWidth() == 0) && (getHeight() == 0) && mTextures[ 0 ].mTextureNormal)
  213. {
  214. setExtent( mTextures[ 0 ].mTextureNormal->getWidth(), mTextures[ 0 ].mTextureNormal->getHeight());
  215. }
  216. }
  217. //-----------------------------------------------------------------------------
  218. void GuiBitmapButtonCtrl::setAutoFitExtents( bool state )
  219. {
  220. mAutoFitExtents = state;
  221. if( mAutoFitExtents )
  222. setBitmap( mBitmapName );
  223. }
  224. //-----------------------------------------------------------------------------
  225. void GuiBitmapButtonCtrl::setBitmap( StringTableEntry name )
  226. {
  227. PROFILE_SCOPE( GuiBitmapButtonCtrl_setBitmap );
  228. _setBitmap(name);
  229. if( !isAwake() )
  230. return;
  231. if( mBitmapAsset.notNull())
  232. {
  233. if( dStricmp( getBitmap(), "texhandle" ) != 0 )
  234. {
  235. const U32 count = mUseModifiers ? NumModifiers : 1;
  236. for( U32 i = 0; i < count; ++ i )
  237. {
  238. static String modifiers[] =
  239. {
  240. "",
  241. "_ctrl",
  242. "_alt",
  243. "_shift"
  244. };
  245. static String s_n[2] = { "_n", "_n_image" };
  246. static String s_d[2] = { "_d", "_d_image" };
  247. static String s_h[2] = { "_h", "_h_image" };
  248. static String s_i[2] = { "_i", "_i_image" };
  249. String baseName = mBitmapAssetId;
  250. //strip any pre-assigned suffix, just in case
  251. baseName = baseName.replace("_n_image", "");
  252. baseName = baseName.replace("_n", "");
  253. if( mUseModifiers )
  254. baseName += modifiers[ i ];
  255. mTextures[ i ].mTextureNormal = GFXTexHandle( mBitmapAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureNormal (line %d)", __FUNCTION__, __LINE__));
  256. if( mUseStates )
  257. {
  258. //normal lookup
  259. StringTableEntry lookupName;
  260. for (U32 s = 0; s < 2; s++)
  261. {
  262. if (!mTextures[i].mTextureNormal)
  263. {
  264. lookupName = StringTable->insert(String(baseName + s_n[s]).c_str());
  265. if (AssetDatabase.isDeclaredAsset(lookupName))
  266. {
  267. mTextures[i].mTextureNormalAssetId = lookupName;
  268. mTextures[i].mTextureNormalAsset = mTextures[i].mTextureNormalAssetId;
  269. }
  270. if (mTextures[i].mTextureNormalAsset.notNull() && mTextures[i].mTextureNormalAsset->getStatus() == AssetBase::Ok)
  271. {
  272. mTextures[i].mTextureNormal = GFXTexHandle(mTextures[i].mTextureNormalAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureNormal (line %d)", __FUNCTION__, __LINE__));
  273. break;
  274. }
  275. }
  276. }
  277. //Hilight lookup
  278. for (U32 s = 0; s < 2; s++)
  279. {
  280. lookupName = StringTable->insert(String(baseName + s_h[s]).c_str());
  281. if (AssetDatabase.isDeclaredAsset(lookupName))
  282. {
  283. mTextures[i].mTextureHilightAssetId = lookupName;
  284. mTextures[i].mTextureHilightAsset = mTextures[i].mTextureHilightAssetId;
  285. }
  286. if (mTextures[i].mTextureHilightAsset.notNull() && mTextures[i].mTextureHilightAsset->getStatus() == AssetBase::Ok)
  287. {
  288. mTextures[i].mTextureHilight = GFXTexHandle(mTextures[i].mTextureHilightAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureHighlight (line %d)", __FUNCTION__, __LINE__));
  289. break;
  290. }
  291. }
  292. if( !mTextures[ i ].mTextureHilight )
  293. mTextures[ i ].mTextureHilight = mTextures[ i ].mTextureNormal;
  294. //Depressed lookup
  295. for (U32 s = 0; s < 2; s++)
  296. {
  297. lookupName = StringTable->insert(String(baseName + s_d[s]).c_str());
  298. if (AssetDatabase.isDeclaredAsset(lookupName))
  299. {
  300. mTextures[i].mTextureDepressedAssetId = lookupName;
  301. mTextures[i].mTextureDepressedAsset = mTextures[i].mTextureDepressedAssetId;
  302. }
  303. if (mTextures[i].mTextureDepressedAsset.notNull() && mTextures[i].mTextureDepressedAsset->getStatus() == AssetBase::Ok)
  304. {
  305. mTextures[i].mTextureDepressed = GFXTexHandle(mTextures[i].mTextureDepressedAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureDepressed (line %d)", __FUNCTION__, __LINE__));
  306. break;
  307. }
  308. }
  309. if( !mTextures[ i ].mTextureDepressed )
  310. mTextures[ i ].mTextureDepressed = mTextures[ i ].mTextureHilight;
  311. //Depressed lookup
  312. for (U32 s = 0; s < 2; s++)
  313. {
  314. lookupName = StringTable->insert(String(baseName + s_i[s]).c_str());
  315. if (AssetDatabase.isDeclaredAsset(lookupName))
  316. {
  317. mTextures[i].mTextureInactiveAssetId = lookupName;
  318. mTextures[i].mTextureInactiveAsset = mTextures[i].mTextureInactiveAssetId;
  319. }
  320. if (mTextures[i].mTextureInactiveAsset.notNull() && mTextures[i].mTextureInactiveAsset->getStatus() == AssetBase::Ok)
  321. {
  322. mTextures[i].mTextureInactive = GFXTexHandle(mTextures[i].mTextureInactiveAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureInactive (line %d)", __FUNCTION__, __LINE__));
  323. break;
  324. }
  325. }
  326. if( !mTextures[ i ].mTextureInactive )
  327. mTextures[ i ].mTextureInactive = mTextures[ i ].mTextureNormal;
  328. }
  329. if( i == 0 && mTextures[ i ].mTextureNormal.isNull() && mTextures[ i ].mTextureHilight.isNull() && mTextures[ i ].mTextureDepressed.isNull() && mTextures[ i ].mTextureInactive.isNull() )
  330. {
  331. Con::warnf( "GuiBitmapButtonCtrl::setBitmap - Unable to load texture: %s", mBitmapName );
  332. this->setBitmap( StringTable->insert(GFXTextureManager::getUnavailableTexturePath().c_str()) );
  333. return;
  334. }
  335. }
  336. }
  337. if( mAutoFitExtents && !mTextures[ 0 ].mTextureNormal.isNull() )
  338. setExtent( mTextures[ 0 ].mTextureNormal.getWidth(), mTextures[ 0 ].mTextureNormal.getHeight() );
  339. }
  340. else
  341. {
  342. for( U32 i = 0; i < NumModifiers; ++ i )
  343. {
  344. mTextures[ i ].mTextureNormal = NULL;
  345. mTextures[ i ].mTextureHilight = NULL;
  346. mTextures[ i ].mTextureDepressed = NULL;
  347. mTextures[ i ].mTextureInactive = NULL;
  348. }
  349. }
  350. setUpdate();
  351. }
  352. //-----------------------------------------------------------------------------
  353. void GuiBitmapButtonCtrl::setBitmapHandles(GFXTexHandle normal, GFXTexHandle highlighted, GFXTexHandle depressed, GFXTexHandle inactive)
  354. {
  355. const U32 count = mUseModifiers ? NumModifiers : 1;
  356. for( U32 i = 0; i < count; ++ i )
  357. {
  358. mTextures[ i ].mTextureNormal = normal;
  359. mTextures[ i ].mTextureHilight = highlighted;
  360. mTextures[ i ].mTextureDepressed = depressed;
  361. mTextures[ i ].mTextureInactive = inactive;
  362. if (!mTextures[ i ].mTextureHilight)
  363. mTextures[ i ].mTextureHilight = mTextures[ i ].mTextureNormal;
  364. if (!mTextures[ i ].mTextureDepressed)
  365. mTextures[ i ].mTextureDepressed = mTextures[ i ].mTextureHilight;
  366. if (!mTextures[ i ].mTextureInactive)
  367. mTextures[ i ].mTextureInactive = mTextures[ i ].mTextureNormal;
  368. if (mTextures[ i ].mTextureNormal.isNull() && mTextures[ i ].mTextureHilight.isNull() && mTextures[ i ].mTextureDepressed.isNull() && mTextures[ i ].mTextureInactive.isNull())
  369. {
  370. Con::warnf("GuiBitmapButtonCtrl::setBitmapHandles() - Invalid texture handles");
  371. setBitmap( StringTable->insert(GFXTextureManager::getUnavailableTexturePath().c_str()) );
  372. return;
  373. }
  374. }
  375. mBitmapName = "texhandle";
  376. }
  377. //------------------------------------------------------------------------------
  378. GuiBitmapButtonCtrl::Modifier GuiBitmapButtonCtrl::getCurrentModifier()
  379. {
  380. U8 modifierKeys = Input::getModifierKeys();
  381. if( modifierKeys & SI_PRIMARY_CTRL )
  382. return ModifierCtrl;
  383. else if( modifierKeys & SI_PRIMARY_ALT )
  384. return ModifierAlt;
  385. else if( modifierKeys & SI_SHIFT )
  386. return ModifierShift;
  387. return ModifierNone;
  388. }
  389. //------------------------------------------------------------------------------
  390. GFXTexHandle& GuiBitmapButtonCtrl::getTextureForCurrentState()
  391. {
  392. U32 index = ModifierNone;
  393. if( mUseModifiers )
  394. index = getCurrentModifier();
  395. if( !mUseStates )
  396. {
  397. if( mTextures[ index ].mTextureNormal )
  398. return mTextures[ 0 ].mTextureNormal;
  399. else
  400. return mTextures[ index ].mTextureNormal;
  401. }
  402. switch( getState() )
  403. {
  404. case NORMAL:
  405. if( !mTextures[ index ].mTextureNormal )
  406. return mTextures[ 0 ].mTextureNormal;
  407. else
  408. return mTextures[ index ].mTextureNormal;
  409. case HILIGHT:
  410. if( !mTextures[ index ].mTextureHilight )
  411. return mTextures[ 0 ].mTextureHilight;
  412. else
  413. return mTextures[ index ].mTextureHilight;
  414. case DEPRESSED:
  415. if( !mTextures[ index ].mTextureDepressed )
  416. return mTextures[ 0 ].mTextureDepressed;
  417. else
  418. return mTextures[ index ].mTextureDepressed;
  419. default:
  420. if( !mTextures[ index ].mTextureInactive )
  421. return mTextures[ 0 ].mTextureInactive;
  422. else
  423. return mTextures[ index ].mTextureInactive;
  424. }
  425. }
  426. //------------------------------------------------------------------------------
  427. void GuiBitmapButtonCtrl::onAction()
  428. {
  429. Parent::onAction();
  430. if( mUseModifiers )
  431. {
  432. switch( getCurrentModifier() )
  433. {
  434. case ModifierNone:
  435. onDefaultClick_callback();
  436. break;
  437. case ModifierCtrl:
  438. onCtrlClick_callback();
  439. break;
  440. case ModifierAlt:
  441. onAltClick_callback();
  442. break;
  443. case ModifierShift:
  444. onShiftClick_callback();
  445. break;
  446. default:
  447. break;
  448. }
  449. }
  450. }
  451. //------------------------------------------------------------------------------
  452. void GuiBitmapButtonCtrl::onRender(Point2I offset, const RectI& updateRect)
  453. {
  454. GFXTexHandle& texture = getTextureForCurrentState();
  455. if( texture )
  456. {
  457. renderButton( texture, offset, updateRect );
  458. renderChildControls( offset, updateRect );
  459. }
  460. else
  461. Parent::onRender(offset, updateRect);
  462. }
  463. //------------------------------------------------------------------------------
  464. void GuiBitmapButtonCtrl::renderButton( GFXTexHandle &texture, const Point2I &offset, const RectI& updateRect )
  465. {
  466. GFX->getDrawUtil()->clearBitmapModulation();
  467. switch( mBitmapMode )
  468. {
  469. case BitmapStretched:
  470. {
  471. RectI rect( offset, getExtent() );
  472. GFX->getDrawUtil()->drawBitmapStretch( texture, rect );
  473. break;
  474. }
  475. case BitmapCentered:
  476. {
  477. Point2I p = offset;
  478. p.x += getExtent().x / 2 - texture.getWidth() / 2;
  479. p.y += getExtent().y / 2 - texture.getHeight() / 2;
  480. GFX->getDrawUtil()->drawBitmap( texture, p );
  481. break;
  482. }
  483. }
  484. }
  485. //=============================================================================
  486. // GuiBitmapButtonTextCtrl.
  487. //=============================================================================
  488. IMPLEMENT_CONOBJECT( GuiBitmapButtonTextCtrl);
  489. ConsoleDocClass( GuiBitmapButtonTextCtrl,
  490. "@brief An extension of GuiBitmapButtonCtrl that additionally renders a text label on the bitmapped button.\n\n"
  491. "The text for the label is taken from the GuiButtonBaseCtrl::text property.\n\n"
  492. "For rendering, the label is placed, relative to the control's upper left corner, at the text offset specified in the "
  493. "control's profile (GuiControlProfile::textOffset) and justified according to the profile's setting (GuiControlProfile::justify).\n\n"
  494. "@see GuiControlProfile::textOffset\n"
  495. "@see GuiControlProfile::justify\n"
  496. "@ingroup GuiButtons"
  497. );
  498. //-----------------------------------------------------------------------------
  499. void GuiBitmapButtonTextCtrl::renderButton( GFXTexHandle &texture, const Point2I &offset, const RectI& updateRect )
  500. {
  501. Parent::renderButton( texture, offset, updateRect );
  502. Point2I textPos = offset;
  503. if(mDepressed)
  504. textPos += Point2I(1,1);
  505. // Make sure we take the profile's textOffset into account.
  506. textPos += mProfile->mTextOffset;
  507. GFX->getDrawUtil()->setBitmapModulation( mProfile->mFontColor );
  508. renderJustifiedText(textPos, getExtent(), mButtonText);
  509. }
  510. bool GuiBitmapButtonCtrl::pointInControl(const Point2I& parentCoordPoint)
  511. {
  512. if (mMasked && getTextureForCurrentState())
  513. {
  514. ColorI rColor(0, 0, 0, 0);
  515. GBitmap* bmp;
  516. const RectI &bounds = getBounds();
  517. S32 xt = parentCoordPoint.x - bounds.point.x;
  518. S32 yt = parentCoordPoint.y - bounds.point.y;
  519. bmp = getTextureForCurrentState().getBitmap();
  520. if (!bmp)
  521. {
  522. setBitmap(mBitmapName);
  523. bmp = getTextureForCurrentState().getBitmap();
  524. }
  525. S32 relativeXRange = this->getExtent().x;
  526. S32 relativeYRange = this->getExtent().y;
  527. S32 fileXRange = bmp->getHeight(0);
  528. S32 fileYRange = bmp->getWidth(0);
  529. //Con::errorf("xRange:[%i -- %i], Range:[%i -- %i] pos:(%i,%i)",relativeXRange,fileXRange,relativeYRange,fileYRange,xt,yt);
  530. S32 fileX = (xt*fileXRange) / relativeXRange;
  531. S32 fileY = (yt*fileYRange) / relativeYRange;
  532. //Con::errorf("Checking %s @ (%i,%i)",this->getName(),fileX,fileY);
  533. bmp->getColor(fileX, fileY, rColor);
  534. if (rColor.alpha)
  535. return true;
  536. else
  537. return false;
  538. }
  539. else
  540. return Parent::pointInControl(parentCoordPoint);
  541. }
  542. DEF_ASSET_BINDS(GuiBitmapButtonCtrl, Bitmap);