JPScrollView

JPScrollView

Allows a HUD container to become a scroll view
Version : 4.0
Price : $50
State : Out

Changelog

v4.0

  • Now compatible with ShiVa 2.0.
  • Plugin API compiled for Mac and Linux in addition to Windows : it will provide API completion in the Script module in ShiVa Editor for each of these operating systems.
  • Now uses a user token instead of an email to activate

v3.1

  • Added function removeUser ( hUser )

v3.0

  • Compatible with multiple local users

v2.6

  • Optimized for ShiVa 1.9.2

v2.5

New functions:

  • bYes = JPScrollView.isUserTouchingView ( sView )
  • bYes = JPScrollView.isViewScrolling ( sView )

v2.4

  • New function: nSpeedX, nSpeedY = JPScrollView.getViewScrollingSpeed ( sView )
  • Fixed a bug with setViewScrollingSpeed on x axis
  • Fixed an issue with JPScrollView.removeView ( sView )

v2.3

New functions:

  • JPScrollView.setViewPosition ( sView, nPositionX, nPositionY, bInstant )
  • nViewMinPositionX, nViewMaxPositionX, nViewMinPositionY, nViewMaxPositionY = JPScrollView.getViewPositionRange ( sView )
  • JPScrollView.setViewScrollingSpeed ( sView, nSpeedX, nSpeedY ) Those functions allow you to scroll the list manually or to manually set the scrolling speed. You can use it for instance with the joypad values to scroll the list.

v2.2

  • Internal modifications to prevent eventual conflicts between packs.

v2.1

  • Added the missing function hChild = JPScrollView.getViewChildAt ( sView, nIndex )

v2.0

  • New feature: Scroll bars, coming with 2 new functions: JPScrollView.setViewScrollBarsEnabled ( sView, bEnabled, bOptAlwaysVisible ) JPScrollView.setScrollBarsScale ( nScale ) nChildCount = JPScrollView.getViewChildCount ( sView ) : to get the child count of the container, without taking the scroll bars into account.

  • You can now change the scrolling behaviour by using these new functions: JPScrollView.setBounceStrengthCoef ( nCoef ) JPScrollView.setDampingStrengthCoef ( nCoef )

  • Other new functions: nPositionX, nPositionY = JPScrollView.getViewPosition ( sView ) nSizeX, nSizeY = JPScrollView.getViewSize ( sView )

  • Changes: JPScrollView.setViewAlignment ( sView, kOptAlignH, kOptAlignV, bOptInstant ) : This function now takes an optional 3rd parameter, to be able to do "Scroll to Top" effects for instance. JPScrollView.addView ( sView, bOptForceScrollX, bOptForceScrollY, bOptForceFullViewScrolling, bOptSkipContainerClipChildren ) : Alignment parameters have been removed, use the JPScrollView.setViewAlignment function instead.

v1.3

  • The scroll view now has a more accurate behavior when the user releases his finger

v1.2

  • Fixed a random issue blocking the activation of the pack

v1.1

  • Error messages now are easier to understand.

API

--JPScrollView API JPScrollView.activate ( sUserToken, sActivationKey ) --Views management JPScrollView.addView ( sView_or_hView, bOptForceScrollX, bOptForceScrollY, bOptForceFullViewScrolling, bOptSkipContainerClipChildren ) hChild = JPScrollView.getViewChildAt ( sView_or_hView, nIndex ) nChildCount = JPScrollView.getViewChildCount ( sView_or_hView ) nPositionX, nPositionY = JPScrollView.getViewPosition ( sView_or_hView ) nViewMinPositionX, nViewMaxPositionX, nViewMinPositionY, nViewMaxPositionY = JPScrollView.getViewPositionRange ( sView_or_hView ) nSpeedX, nSpeedY = JPScrollView.getViewScrollingSpeed ( sView_or_hView ) nSizeX, nSizeY = JPScrollView.getViewSize ( sView_or_hView ) bYes = JPScrollView.isUserTouchingView ( sView_or_hView ) bYes = JPScrollView.isViewScrolling ( sView_or_hView ) JPScrollView.removeView ( sView_or_hView ) JPScrollView.setViewAlignment ( sView_or_hView, kOptAlignH, kOptAlignV, bOptInstant ) JPScrollView.setViewPosition ( sView_or_hView, nPositionX, nPositionY, bInstant ) JPScrollView.setViewScrollingSpeed ( sView_or_hView, nSpeedX, nSpeedY ) JPScrollView.viewSizeDidChange ( sView_or_hView, bOptInstant ) --Scrolling behaviour JPScrollView.setBounceStrengthCoef ( nCoef ) JPScrollView.setDampingStrengthCoef ( nCoef ) --Scroll bars management JPScrollView.setScrollBarsScale ( nScale ) JPScrollView.setViewScrollBarsEnabled ( sView_or_hView, bEnabled, bOptAlwaysVisible ) JPScrollView.addUser ( hUser ) JPScrollView.removeUser ( hUser )

Description

Like UIScrollView for iOS, JPScrollView will allow you to scroll the entire contents of a HUD container.

Simply define a container as a ScrollView and all its children will get the possibility to be scrolled in the view (the container) with the finger or mouse, like for a web page in a browser, with rebound effects when you are out of the area. This pack is the perfect choice for a lot of things in games, such as display of scores, trophies or for lists of objects of your in-game store for example.

JPScrollView also enhance views with very nice scrollbars that you'll love for sure!

With such a pack you will increase significantly the quality of your game, it will look well polished, fluid, enjoyable, etc.. Try the sample to see for yourself!