guiBitmapButtonCtrl.cpp 25 KB

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