guiBitmapButtonCtrl.cpp 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653
  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. mColor = ColorI::WHITE;
  108. INIT_ASSET(Bitmap);
  109. }
  110. //-----------------------------------------------------------------------------
  111. void GuiBitmapButtonCtrl::initPersistFields()
  112. {
  113. addGroup( "Bitmap" );
  114. addProtectedField("Bitmap", TypeImageFilename, Offset(mBitmapName, GuiBitmapButtonCtrl), _setBitmapFieldData, &defaultProtectedGetFn, "Texture file to display on this button.\n"
  115. "If useStates is false, this will be the file that renders on the control. Otherwise, this will "
  116. "specify the default texture name to which the various state and modifier suffixes are appended "
  117. "to find the per-state and per-modifier (if enabled) textures.", AbstractClassRep::FIELD_HideInInspectors); \
  118. addProtectedField("BitmapAsset", TypeImageAssetId, Offset(mBitmapAssetId, GuiBitmapButtonCtrl), _setBitmapFieldData, &defaultProtectedGetFn, "Texture file to display on this button.\n"
  119. "If useStates is false, this will be the file that renders on the control. Otherwise, this will "
  120. "specify the default texture name to which the various state and modifier suffixes are appended "
  121. "to find the per-state and per-modifier (if enabled) textures.");
  122. addField("color", TypeColorI, Offset(mColor, GuiBitmapButtonCtrl), "color mul");
  123. addField( "bitmapMode", TYPEID< BitmapMode >(), Offset( mBitmapMode, GuiBitmapButtonCtrl ),
  124. "Behavior for fitting the bitmap to the control extents.\n"
  125. "If set to 'Stretched', the bitmap will be stretched both verticall and horizontally to fit inside "
  126. "the control's extents.\n\n"
  127. "If set to 'Centered', the bitmap will stay at its original resolution centered in the control's "
  128. "rectangle (getting clipped if the control is smaller than the texture)." );
  129. addProtectedField( "autoFitExtents", TypeBool, Offset( mAutoFitExtents, GuiBitmapButtonCtrl ),
  130. &_setAutoFitExtents, &defaultProtectedGetFn,
  131. "If true, the control's extents will be set to match the bitmap's extents when setting the bitmap.\n"
  132. "The bitmap extents will always be taken from the default/normal bitmap (in case the extents of the various "
  133. "bitmaps do not match up.)" );
  134. addField( "useModifiers", TypeBool, Offset( mUseModifiers, GuiBitmapButtonCtrl ),
  135. "If true, per-modifier button functionality is enabled.\n"
  136. "@ref guibitmapbutton_modifiers" );
  137. addField( "useStates", TypeBool, Offset( mUseStates, GuiBitmapButtonCtrl ),
  138. "If true, per-mouse state button functionality is enabled.\n"
  139. "Defaults to true.\n\n"
  140. "If you do not use per-state images on this button set this to false to speed up the loading process "
  141. "by inhibiting searches for the individual images." );
  142. addField("masked", TypeBool, Offset(mMasked, GuiBitmapButtonCtrl),"Use alpha masking for interaction.");
  143. endGroup( "Bitmap" );
  144. Parent::initPersistFields();
  145. }
  146. //-----------------------------------------------------------------------------
  147. bool GuiBitmapButtonCtrl::onWake()
  148. {
  149. if (! Parent::onWake())
  150. return false;
  151. setActive( true );
  152. setBitmap( getBitmap() );
  153. return true;
  154. }
  155. //-----------------------------------------------------------------------------
  156. void GuiBitmapButtonCtrl::onSleep()
  157. {
  158. if( dStricmp(mBitmapName, "texhandle") != 0 )
  159. for( U32 i = 0; i < NumModifiers; ++ i )
  160. {
  161. mTextures[ i ].mTextureNormal = NULL;
  162. mTextures[ i ].mTextureHilight = NULL;
  163. mTextures[ i ].mTextureDepressed = NULL;
  164. mTextures[ i ].mTextureInactive = NULL;
  165. }
  166. Parent::onSleep();
  167. }
  168. //-----------------------------------------------------------------------------
  169. bool GuiBitmapButtonCtrl::_setAutoFitExtents( void *object, const char *index, const char *data )
  170. {
  171. GuiBitmapButtonCtrl* ctrl = reinterpret_cast< GuiBitmapButtonCtrl* >( object );
  172. ctrl->setAutoFitExtents( dAtob( data ) );
  173. return false;
  174. }
  175. //-----------------------------------------------------------------------------
  176. /*bool GuiBitmapButtonCtrl::_setBitmap(void* object, const char* index, const char* data)
  177. {
  178. GuiBitmapButtonCtrl* ctrl = reinterpret_cast< GuiBitmapButtonCtrl* >( object );
  179. ctrl->setBitmap( StringTable->insert(data) );
  180. return false;
  181. }*/
  182. //-----------------------------------------------------------------------------
  183. // Legacy method. Can just assign to bitmap field.
  184. /*DefineEngineMethod(GuiBitmapButtonCtrl, setBitmap, void, (const char* path), ,
  185. "Set the bitmap to show on the button.\n"
  186. "@param path Path to the texture file in any of the supported formats.\n" )
  187. {
  188. object->setBitmap( StringTable->insert(path) );
  189. }*/
  190. //-----------------------------------------------------------------------------
  191. void GuiBitmapButtonCtrl::inspectPostApply()
  192. {
  193. Parent::inspectPostApply();
  194. setBitmap(getBitmap());
  195. // if the extent is set to (0,0) in the gui editor and appy hit, this control will
  196. // set it's extent to be exactly the size of the normal bitmap (if present)
  197. if ((getWidth() == 0) && (getHeight() == 0) && mTextures[ 0 ].mTextureNormal)
  198. {
  199. setExtent( mTextures[ 0 ].mTextureNormal->getWidth(), mTextures[ 0 ].mTextureNormal->getHeight());
  200. }
  201. }
  202. //-----------------------------------------------------------------------------
  203. void GuiBitmapButtonCtrl::setAutoFitExtents( bool state )
  204. {
  205. mAutoFitExtents = state;
  206. if( mAutoFitExtents )
  207. setBitmap( mBitmapName );
  208. }
  209. //-----------------------------------------------------------------------------
  210. void GuiBitmapButtonCtrl::setBitmap( StringTableEntry name )
  211. {
  212. PROFILE_SCOPE( GuiBitmapButtonCtrl_setBitmap );
  213. _setBitmap(name);
  214. if( !isAwake() )
  215. return;
  216. if( mBitmapAsset.notNull())
  217. {
  218. if( dStricmp( getBitmap(), "texhandle" ) != 0 )
  219. {
  220. const U32 count = mUseModifiers ? NumModifiers : 1;
  221. for( U32 i = 0; i < count; ++ i )
  222. {
  223. static String modifiers[] =
  224. {
  225. "",
  226. "_ctrl",
  227. "_alt",
  228. "_shift"
  229. };
  230. static String s_n[2] = { "_n", "_n_image" };
  231. static String s_d[2] = { "_d", "_d_image" };
  232. static String s_h[2] = { "_h", "_h_image" };
  233. static String s_i[2] = { "_i", "_i_image" };
  234. String baseName = mBitmapAssetId;
  235. //strip any pre-assigned suffix, just in case
  236. baseName = baseName.replace("_n_image", "");
  237. baseName = baseName.replace("_n", "");
  238. if( mUseModifiers )
  239. baseName += modifiers[ i ];
  240. mTextures[ i ].mTextureNormal = GFXTexHandle( mBitmapAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureNormal (line %d)", __FUNCTION__, __LINE__));
  241. if( mUseStates )
  242. {
  243. //normal lookup
  244. StringTableEntry lookupName;
  245. for (U32 s = 0; s < 2; s++)
  246. {
  247. if (!mTextures[i].mTextureNormal)
  248. {
  249. lookupName = StringTable->insert(String(baseName + s_n[s]).c_str());
  250. if (AssetDatabase.isDeclaredAsset(lookupName))
  251. {
  252. mTextures[i].mTextureNormalAssetId = lookupName;
  253. mTextures[i].mTextureNormalAsset = mTextures[i].mTextureNormalAssetId;
  254. }
  255. if (mTextures[i].mTextureNormalAsset.notNull() && mTextures[i].mTextureNormalAsset->getStatus() == AssetBase::Ok)
  256. {
  257. mTextures[i].mTextureNormal = GFXTexHandle(mTextures[i].mTextureNormalAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureNormal (line %d)", __FUNCTION__, __LINE__));
  258. break;
  259. }
  260. }
  261. }
  262. //Hilight lookup
  263. for (U32 s = 0; s < 2; s++)
  264. {
  265. lookupName = StringTable->insert(String(baseName + s_h[s]).c_str());
  266. if (AssetDatabase.isDeclaredAsset(lookupName))
  267. {
  268. mTextures[i].mTextureHilightAssetId = lookupName;
  269. mTextures[i].mTextureHilightAsset = mTextures[i].mTextureHilightAssetId;
  270. }
  271. if (mTextures[i].mTextureHilightAsset.notNull() && mTextures[i].mTextureHilightAsset->getStatus() == AssetBase::Ok)
  272. {
  273. mTextures[i].mTextureHilight = GFXTexHandle(mTextures[i].mTextureHilightAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureHighlight (line %d)", __FUNCTION__, __LINE__));
  274. break;
  275. }
  276. }
  277. if( !mTextures[ i ].mTextureHilight )
  278. mTextures[ i ].mTextureHilight = mTextures[ i ].mTextureNormal;
  279. //Depressed lookup
  280. for (U32 s = 0; s < 2; s++)
  281. {
  282. lookupName = StringTable->insert(String(baseName + s_d[s]).c_str());
  283. if (AssetDatabase.isDeclaredAsset(lookupName))
  284. {
  285. mTextures[i].mTextureDepressedAssetId = lookupName;
  286. mTextures[i].mTextureDepressedAsset = mTextures[i].mTextureDepressedAssetId;
  287. }
  288. if (mTextures[i].mTextureDepressedAsset.notNull() && mTextures[i].mTextureDepressedAsset->getStatus() == AssetBase::Ok)
  289. {
  290. mTextures[i].mTextureDepressed = GFXTexHandle(mTextures[i].mTextureDepressedAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureDepressed (line %d)", __FUNCTION__, __LINE__));
  291. break;
  292. }
  293. }
  294. if( !mTextures[ i ].mTextureDepressed )
  295. mTextures[ i ].mTextureDepressed = mTextures[ i ].mTextureHilight;
  296. //Depressed lookup
  297. for (U32 s = 0; s < 2; s++)
  298. {
  299. lookupName = StringTable->insert(String(baseName + s_i[s]).c_str());
  300. if (AssetDatabase.isDeclaredAsset(lookupName))
  301. {
  302. mTextures[i].mTextureInactiveAssetId = lookupName;
  303. mTextures[i].mTextureInactiveAsset = mTextures[i].mTextureInactiveAssetId;
  304. }
  305. if (mTextures[i].mTextureInactiveAsset.notNull() && mTextures[i].mTextureInactiveAsset->getStatus() == AssetBase::Ok)
  306. {
  307. mTextures[i].mTextureInactive = GFXTexHandle(mTextures[i].mTextureInactiveAsset->getImagePath(), &GFXDefaultGUIProfile, avar("%s() - mTextureInactive (line %d)", __FUNCTION__, __LINE__));
  308. break;
  309. }
  310. }
  311. if( !mTextures[ i ].mTextureInactive )
  312. mTextures[ i ].mTextureInactive = mTextures[ i ].mTextureNormal;
  313. }
  314. if( i == 0 && mTextures[ i ].mTextureNormal.isNull() && mTextures[ i ].mTextureHilight.isNull() && mTextures[ i ].mTextureDepressed.isNull() && mTextures[ i ].mTextureInactive.isNull() )
  315. {
  316. Con::warnf( "GuiBitmapButtonCtrl::setBitmap - Unable to load texture: %s", mBitmapName );
  317. this->setBitmap( StringTable->insert(GFXTextureManager::getUnavailableTexturePath().c_str()) );
  318. return;
  319. }
  320. }
  321. }
  322. if( mAutoFitExtents && !mTextures[ 0 ].mTextureNormal.isNull() )
  323. setExtent( mTextures[ 0 ].mTextureNormal.getWidth(), mTextures[ 0 ].mTextureNormal.getHeight() );
  324. }
  325. else
  326. {
  327. for( U32 i = 0; i < NumModifiers; ++ i )
  328. {
  329. mTextures[ i ].mTextureNormal = NULL;
  330. mTextures[ i ].mTextureHilight = NULL;
  331. mTextures[ i ].mTextureDepressed = NULL;
  332. mTextures[ i ].mTextureInactive = NULL;
  333. }
  334. }
  335. setUpdate();
  336. }
  337. //-----------------------------------------------------------------------------
  338. void GuiBitmapButtonCtrl::setBitmapHandles(GFXTexHandle normal, GFXTexHandle highlighted, GFXTexHandle depressed, GFXTexHandle inactive)
  339. {
  340. const U32 count = mUseModifiers ? NumModifiers : 1;
  341. for( U32 i = 0; i < count; ++ i )
  342. {
  343. mTextures[ i ].mTextureNormal = normal;
  344. mTextures[ i ].mTextureHilight = highlighted;
  345. mTextures[ i ].mTextureDepressed = depressed;
  346. mTextures[ i ].mTextureInactive = inactive;
  347. if (!mTextures[ i ].mTextureHilight)
  348. mTextures[ i ].mTextureHilight = mTextures[ i ].mTextureNormal;
  349. if (!mTextures[ i ].mTextureDepressed)
  350. mTextures[ i ].mTextureDepressed = mTextures[ i ].mTextureHilight;
  351. if (!mTextures[ i ].mTextureInactive)
  352. mTextures[ i ].mTextureInactive = mTextures[ i ].mTextureNormal;
  353. if (mTextures[ i ].mTextureNormal.isNull() && mTextures[ i ].mTextureHilight.isNull() && mTextures[ i ].mTextureDepressed.isNull() && mTextures[ i ].mTextureInactive.isNull())
  354. {
  355. Con::warnf("GuiBitmapButtonCtrl::setBitmapHandles() - Invalid texture handles");
  356. setBitmap( StringTable->insert(GFXTextureManager::getUnavailableTexturePath().c_str()) );
  357. return;
  358. }
  359. }
  360. mBitmapName = "texhandle";
  361. }
  362. //------------------------------------------------------------------------------
  363. GuiBitmapButtonCtrl::Modifier GuiBitmapButtonCtrl::getCurrentModifier()
  364. {
  365. U8 modifierKeys = Input::getModifierKeys();
  366. if( modifierKeys & SI_PRIMARY_CTRL )
  367. return ModifierCtrl;
  368. else if( modifierKeys & SI_PRIMARY_ALT )
  369. return ModifierAlt;
  370. else if( modifierKeys & SI_SHIFT )
  371. return ModifierShift;
  372. return ModifierNone;
  373. }
  374. //------------------------------------------------------------------------------
  375. GFXTexHandle& GuiBitmapButtonCtrl::getTextureForCurrentState()
  376. {
  377. U32 index = ModifierNone;
  378. if( mUseModifiers )
  379. index = getCurrentModifier();
  380. if( !mUseStates )
  381. {
  382. if( mTextures[ index ].mTextureNormal )
  383. return mTextures[ 0 ].mTextureNormal;
  384. else
  385. return mTextures[ index ].mTextureNormal;
  386. }
  387. switch( getState() )
  388. {
  389. case NORMAL:
  390. if( !mTextures[ index ].mTextureNormal )
  391. return mTextures[ 0 ].mTextureNormal;
  392. else
  393. return mTextures[ index ].mTextureNormal;
  394. case HILIGHT:
  395. if( !mTextures[ index ].mTextureHilight )
  396. return mTextures[ 0 ].mTextureHilight;
  397. else
  398. return mTextures[ index ].mTextureHilight;
  399. case DEPRESSED:
  400. if( !mTextures[ index ].mTextureDepressed )
  401. return mTextures[ 0 ].mTextureDepressed;
  402. else
  403. return mTextures[ index ].mTextureDepressed;
  404. default:
  405. if( !mTextures[ index ].mTextureInactive )
  406. return mTextures[ 0 ].mTextureInactive;
  407. else
  408. return mTextures[ index ].mTextureInactive;
  409. }
  410. }
  411. //------------------------------------------------------------------------------
  412. void GuiBitmapButtonCtrl::onAction()
  413. {
  414. Parent::onAction();
  415. if( mUseModifiers )
  416. {
  417. switch( getCurrentModifier() )
  418. {
  419. case ModifierNone:
  420. onDefaultClick_callback();
  421. break;
  422. case ModifierCtrl:
  423. onCtrlClick_callback();
  424. break;
  425. case ModifierAlt:
  426. onAltClick_callback();
  427. break;
  428. case ModifierShift:
  429. onShiftClick_callback();
  430. break;
  431. default:
  432. break;
  433. }
  434. }
  435. }
  436. //------------------------------------------------------------------------------
  437. void GuiBitmapButtonCtrl::onRender(Point2I offset, const RectI& updateRect)
  438. {
  439. GFXTexHandle& texture = getTextureForCurrentState();
  440. if( texture )
  441. {
  442. renderButton( texture, offset, updateRect );
  443. renderChildControls( offset, updateRect );
  444. }
  445. else
  446. Parent::onRender(offset, updateRect);
  447. }
  448. //------------------------------------------------------------------------------
  449. void GuiBitmapButtonCtrl::renderButton( GFXTexHandle &texture, const Point2I &offset, const RectI& updateRect )
  450. {
  451. GFX->getDrawUtil()->clearBitmapModulation();
  452. GFX->getDrawUtil()->setBitmapModulation(mColor);
  453. switch( mBitmapMode )
  454. {
  455. case BitmapStretched:
  456. {
  457. RectI rect( offset, getExtent() );
  458. GFX->getDrawUtil()->drawBitmapStretch( texture, rect );
  459. break;
  460. }
  461. case BitmapCentered:
  462. {
  463. Point2I p = offset;
  464. p.x += getExtent().x / 2 - texture.getWidth() / 2;
  465. p.y += getExtent().y / 2 - texture.getHeight() / 2;
  466. GFX->getDrawUtil()->drawBitmap( texture, p );
  467. break;
  468. }
  469. }
  470. }
  471. //=============================================================================
  472. // GuiBitmapButtonTextCtrl.
  473. //=============================================================================
  474. IMPLEMENT_CONOBJECT( GuiBitmapButtonTextCtrl);
  475. ConsoleDocClass( GuiBitmapButtonTextCtrl,
  476. "@brief An extension of GuiBitmapButtonCtrl that additionally renders a text label on the bitmapped button.\n\n"
  477. "The text for the label is taken from the GuiButtonBaseCtrl::text property.\n\n"
  478. "For rendering, the label is placed, relative to the control's upper left corner, at the text offset specified in the "
  479. "control's profile (GuiControlProfile::textOffset) and justified according to the profile's setting (GuiControlProfile::justify).\n\n"
  480. "@see GuiControlProfile::textOffset\n"
  481. "@see GuiControlProfile::justify\n"
  482. "@ingroup GuiButtons"
  483. );
  484. //-----------------------------------------------------------------------------
  485. void GuiBitmapButtonTextCtrl::renderButton( GFXTexHandle &texture, const Point2I &offset, const RectI& updateRect )
  486. {
  487. Parent::renderButton( texture, offset, updateRect );
  488. Point2I textPos = offset;
  489. if(mDepressed)
  490. textPos += Point2I(1,1);
  491. // Make sure we take the profile's textOffset into account.
  492. textPos += mProfile->mTextOffset;
  493. GFX->getDrawUtil()->setBitmapModulation( mProfile->mFontColor );
  494. renderJustifiedText(textPos, getExtent(), mButtonText);
  495. }
  496. bool GuiBitmapButtonCtrl::pointInControl(const Point2I& parentCoordPoint)
  497. {
  498. if (mMasked && getTextureForCurrentState())
  499. {
  500. ColorI rColor(0, 0, 0, 0);
  501. GBitmap* bmp;
  502. const RectI &bounds = getBounds();
  503. S32 xt = parentCoordPoint.x - bounds.point.x;
  504. S32 yt = parentCoordPoint.y - bounds.point.y;
  505. bmp = getTextureForCurrentState().getBitmap();
  506. if (!bmp)
  507. {
  508. setBitmap(mBitmapName);
  509. bmp = getTextureForCurrentState().getBitmap();
  510. }
  511. S32 relativeXRange = this->getExtent().x;
  512. S32 relativeYRange = this->getExtent().y;
  513. S32 fileXRange = bmp->getHeight(0);
  514. S32 fileYRange = bmp->getWidth(0);
  515. //Con::errorf("xRange:[%i -- %i], Range:[%i -- %i] pos:(%i,%i)",relativeXRange,fileXRange,relativeYRange,fileYRange,xt,yt);
  516. S32 fileX = (xt*fileXRange) / relativeXRange;
  517. S32 fileY = (yt*fileYRange) / relativeYRange;
  518. //Con::errorf("Checking %s @ (%i,%i)",this->getName(),fileX,fileY);
  519. bmp->getColor(fileX, fileY, rColor);
  520. if (rColor.alpha)
  521. return true;
  522. else
  523. return false;
  524. }
  525. else
  526. return Parent::pointInControl(parentCoordPoint);
  527. }
  528. DEF_ASSET_BINDS(GuiBitmapButtonCtrl, Bitmap);