B4A Library B4APhotoPager v3.85

B4APhotoPager v3.80 By Giuseppe Salvi


B4APhotoPager
Author: Giuseppe Salvi
Version: 3.8

  • Properties:
    • FromAssets As String [read only]
      Returns a references to the file added to the files tab. These file are read-only.
    • FromExtSdCard As String [read only]
      Returns image is located on the local file system or external SD card.
    • FromHttp As String [read only]
      Returns image is located in the network.
    • FromHttps As String [read only]
      Returns the image is located in the network.
    • FromSdCard As String [read only]
      Returns image is located on the local file system or SD card

  • Fields:
    • Compress_Format_JPG As CompressFormat
      Compression Format JPG
    • Compress_Format_PNG As CompressFormat
      Compression Format PNG

  • Fields:
    • Accordion As Int
    • BgToFg As Int
    • CardSlide As Int
    • Default As Int
    • DeptPage As Int
    • FadeInOut As Int
    • FgToBg As Int
    • FlipHorizontal As Int
    • FlipVertical As Int
    • HorizontalCube As Int
    • HorizontalElastic As Int
    • RotateDown As Int
    • RotateUp As Int
    • Rotation As Int
    • RotationSquare As Int
    • ScaleBgToFg As Int
    • Stack As Int
    • Tablet As Int
    • Transition_01 As Int
    • Transition_02 As Int
    • Transition_03 As Int
    • VerticalCube As Int
    • VerticalElastic As Int
    • ZoomIn As Int
    • ZoomOut As Int
    • ZoomOutSlide As Int

  • Fields:
    • Center As ScaleType
      Center the image in the view, but perform no scaling.
    • Center_Crop As ScaleType
      Scale the image uniformly (maintain the image's aspect ratio) so that both dimensions (width and height) of the image
      will be equal to or larger than the corresponding dimension of the view (minus padding).
    • Center_Inside As ScaleType
      Scale the image uniformly (maintain the image's aspect ratio) so that both dimensions (width and height) of the image
      will be equal to or less than the corresponding dimension of the view (minus padding).
    • Fit_Center As ScaleType
      Scale the image using CENTER.
    • Fit_End As ScaleType
      Scale the image using END.
    • Fit_Start As ScaleType
      Scale the image using START.
    • Fit_XY As ScaleType
      Scale the image using FILL.
  • PhotoPager
    Events:
    • Click
    • LongClick
    • MatrixChanged (Left As Int, Top As Int, Right As Int, Bottom As Int, Width As Int, Height As Int, CenterX As Int, CenterY As Int)
    • PageScrollStateChanged (State As Int)
    • PageScrolled (Position As Int, PositionOffset As Float, PositionOffsetPixels As Int)
    • PageSelected (Position As Int)
    • Ready
    • ScaleChanged (ScaleFactor As Int, FocusX As Int, FocusY As Int)
    Methods:
    • AddImage (dir As String, file As String)
      Add an image from sdcard or AssetsDir at the end of the view pager .
    • AddImageAt (index As Int, dir As String, file As String)
      Add an image from sdcard or AssetsDir to the desired position in the view pager.
    • AddImageFromWeb (address As String)
      Add an image from web and from Dropbox at the end of the view pager.
    • AddImageFromWebAt (index As Int, address As String)
      Add an image from web and from Dropbox to the desired position in the view pager.
    • AddView (view As View)
      Adds a view to the page.
      view: View
    • AddView2 (view As View, left As Int, top As Int, width As Int, height As Int)
      Adds a view to the page.
      view: View
      left: Left
      top: Top
      width: Width
      height: Height
    • AddViewAt (index As Int, view As View)
      Adds a view to the specified index.
      index: Page index
      view: View
    • AddViewAt2 (index As Int, view As View, left As Int, top As Int, width As Int, height As Int)
      Adds a view to the specified index.
      view: View
      left: Left
      top: Top
      width: Width
      height: Height
    • BringToFront
    • ClearDiskCache
      Clears disk cache.
    • ClearMemoryCache
      Clears memory cache.
    • DestroyEngine
      Stops ImageLoader and clears current configuration. Use this option on exit app.
    • GetArrayList As List
      Get array from GridView, Gallery, PhotoFlow.
    • GetImageListFromAssets (path As String, sort As Boolean) As List
      Get entire list of images stored in assets or sub-folder
      Examples:
      <code>
      Dim lv as ListView
      Dim l as list
      l.Initialize
      lv.Initialize("lv")
      Sub Menu_Click
      Activity.AddView(lv,0,0,100%x,100%y)
      l = vp.GetImageListFromAssets("Here the Images folder stored in Assets")
      or
      l = vp.GetImageListFromAssets(File.DirAssets)
      or
      l = vp.GetImageListFromAssets("")
      For n = 0 To l.Size-1
      lv.AddSingleLine(l.Get(n))
      next
      End Sub
      </code>
    • GetItem (position As Int) As String
      Returns Item
      Example:
      i.Bitmap=LoadBitmap("",g.GetItem(Position))
    • GetPageTag (index As Int) As Object
      Get or Sets the tag associated with this views. A tag can be used to mark
      a view in its hierarchy and does not have to be unique within the
      hierarchy. Tags can also be used to store data within a view without
      resorting to another data structure.
      index: the index of the page
      tag: return the Object stored in this view as a tag, or null if not set
    • GoToPage (item As Int, smoothScroll As Boolean)
      Get or Sets the currently selected page.
    • Initialize (EventName As String, initializeView As Boolean)
      Initialize the object
    • IsDoubleTapEnabled As Boolean
      Gets double tap from the page.
    • IsFadeEnabled As Boolean
      Gets fade from the page.
    • IsInitialized As Boolean
    • IsLockEnabled As Boolean
      Gets lock from the page.
    • IsPageEnabled (index As Int) As Boolean
      Returns the enabled status for this view. The interpretation of the
      enabled state varies by subclass.
      index: Page index
      Return type: @return:True if this view is enabled, false otherwise.
    • IsPageVisible (index As Int) As Boolean
      Returns the enabled status for this view. The interpretation of the
      enabled state varies by subclass.
      index: Page index
      Return type: @return:True if the view in this page is visible, false otherwise.
    • IsZoomEnabled As Boolean
      Gets zoom from the page.
    • LoadBitmap (Dir As String, FileName As String) As Bitmap
      Loads and decodes image synchronously.
      FileName: Image
      Example:
      <code>
      File.FromAssets,"image.png"
      or
      "assets://","image.png"
      File.FromSdCard,"image.png"
      or
      "file:///mnt/sdcard/","image.png"
      File.FromExtSdCard,"image.png"
      or
      "file:///mnt/extSdCard/","image.png"

      File.FromHttp,"image.png",width,height
      or
      "http://","site.com/image.png",width,height
      File.FromHttps,"image.png",width,height
      or
      "https://","site.com/image.png",width,heigh
      </code>
      Result image Bitmap. Can be <b>null</b> if image loading/decoding was failed or cancelled.
    • LoadBitmap2 (Dir As String, FileName As String, width As Int, height As Int) As Bitmap
      Loads and decodes image synchronously
      FileName: Image
      width: ImageSize
      height: ImageSize
      Example:
      <code>
      File.FromAssets,"image.png",width,height
      or
      "assets://","image.png",width,height
      File.FromSdCard,"image.png",width,height
      or
      "file:///mnt/sdcard/","image.png",width,height
      File.FromExtSdCard,"image.png",width,height
      or
      "file:///mnt/extSdCard/","image.png",width,height
      File.FromHttp,"image.png",width,height
      or
      "http://","site.com/image.png",width,height
      File.FromHttps,"image.png",width,height
      or
      "https://","site.com/image.png",width,heigh
      </code>
      targetImageSize: Minimal size for bitmap which will be returned. Downloaded image will be decoded
      and scaled to bitmap of the size which is <b>equal or larger</b> (usually a bit
      larger) than incoming targetImageSize.
      Result image Bitmap. Can be <b>null</b> if image loading/decoding was failed or cancelled.
    • LoadLayout (FileName As String)
      Loads a layout file(.bal) to PhotoPager as a view.
      LayoutFile: Load a LayoutFile created with designer
    • LoadLayout2 (index As Int, FileName As String)
      Loads a layout file(.bal) to PhotoPager to the specified index.
      index: Page index
      FileName: Load a LayoutFile created with designer
    • PauseEngine
      Pause ImageLoader. All new load and display tasks won't be executed until ImageLoader is resumed.
      Already running tasks are not paused.
    • RemoveAllViews
      Removes all child views.
    • RemoveViewAt (index As Int)
      Removes the view that is stored in specified index.
      index: Page index
    • ResumeEngine
      Resumes waiting load and display tasks.
    • SetArrayList (array As ArrayList)
      Set an array passed from, gallery, grid view, cover flow.
    • SetPageBackgroundColor (index As Int, color As Int)
      Sets Background Color to the page.
      index: Page index
      color: Page color
    • SetPageBackgroundImage (index As Int, bitmap As Bitmap)
      Sets Background bitmap to the page.
      index: Page index
      bitmap: Page bitmap
    • SetPageEnabled (index As Int, enabled As Boolean)
      Set the enabled state of this view. The interpretation of the enabled
      state varies by subclass.
      index: Page index
      enabled: True if this view is enabled, false otherwise.
    • SetPageTag (index As Int, tag As Object)
      Get or Sets the tag associated with this views. A tag can be used to mark
      a view in its hierarchy and does not have to be unique within the
      hierarchy. Tags can also be used to store data within a view without
      resorting to another data structure.
      index: the index of the page
      tag: set the Object stored in this view as a tag
    • SetPageVisible (index As Int, visible As Boolean)
      Set the enabled state of this view.
      index: Page index
      visibility: True if this view is enabled, false otherwise.
    • SetPanelBackgroundColor (index As Int, color As Int)
      Sets Background Color to the panel.
      index: Panel index
      color: Panel color
    • SetPanelBackgroundImage (index As Int, bitmap As Bitmap)
      Sets Background bitmap to the panel.
      index: Panel index
      bitmap: Panel bitmap
    • SetVisibleAnimated (arg0 As Int, arg1 As Boolean)
    • ShowFromAssets (path As String, sort As Boolean)
      show images from assets or sub-folder not from sdcard.
    • ShowFromBucket (path As String, sort As Boolean)
      Show from media bucket
      path:
      sort:
    • ShowFromMediaStore (sort As Boolean)
      show images from media store.
    • ShowFromSdCard (dir As String, path As String, sort As Boolean)
      show images from sdcard not from assets.
    • ShowFromWeb (webStrings() As String, sort As Boolean)
      show images from web.
    • StopEngine
      Cancels all running and scheduled display image tasks.
      <b>NOTE:</b> This method doesn't shutdown if you set them.
      ImageLoader still can be used after calling this method.
    • SwapView (i As Int, j As Int)
      Swaps the elements at the specified positions in the specified list.
      (If the specified positions are equal, invoking this method leaves
      the list unchanged.)
      i: the index of one element to be swapped.
      j: the index of the other element to be swapped.
    Permissions:
    • android.permission.INTERNET
    • android.permission.MEDIA_CONTENT_CONTROL
    • android.permission.READ_EXTERNAL_STORAGE
    • android.permission.WRITE_EXTERNAL_STORAGE
    Properties:
    • AdjustViewBounds As Boolean
      Get or Sets this to true if you want the ImageView to adjust its bounds to preserve the aspect ratio of its drawable.
    • BackGroundColor As Object [write only]
      Get or Sets the background color for this view.
      Example:
      BackGroundColor = Color.Aqua
      BackGroundColor = "#88666666"
      or
      BackGroundColor = Colors.ARGB(100,20,20,20) or Colors.RGB(20,20,20)
    • Background As Drawable
    • BackgroundColorRandomly As Boolean [write only]
      Set the Background Color Randomly.
    • CacheInMemory As Boolean [write only]
      Sets whether loaded image will be cached in memory - by default false.
    • CacheOnDisk As Boolean [write only]
      Sets whether loaded image will be cached on disk - by default false.
    • Color As Colors
      Returns one of the Color value in the list
    • CompressFormat As PhotoPagerBitmaCompression
      Get or Sets the known formats a bitmap can be compressed into [ JPG or PNG ]
    • CompressQuality As Int
      Get or Sets the quality of a bitmap, that can be compressed. [ 0 = low -> 100 = high ]
    • CurrentItem As Void
      Get or Sets the currently selected page.
    • DoubleTapEnabled As Boolean [write only]
      Sets double tap to the page.
    • FadeEnabled As Boolean [write only]
      Sets fade to the page.
    • FadeInTime As Int [write only]
      Duration of "fade-in" animation (in milliseconds)
      Whether animation should be played if image is loaded from network
      Whether animation should be played if image is loaded from disk cache
      Whether animation should be played if image is loaded from memory cache.
    • File As Files [read only]
      Return File:
      File.FromAssets
      File.FromSdCard
      File.FromExtSdCard
      File.FromHttp
      File.FromHttps
    • Length As Int [read only]
      Returns length.
    • LockEnabled As Boolean [write only]
      Sets lock to the page.
    • MaximumScale As Float [write only]
      Sets the maximum scale
    • MediumScale As Float [write only]
      Sets the medium scale
    • MinimumScale As Float [write only]
      Sets the minimum scale
    • OutlineColor As Int [write only]
      Sets outline color to photo pager.
    • OutlineEnabled As Boolean [write only]
      Enable or disable outline to photo pager.
    • Parent As Object [read only]
    • ProgressBarVisible As Boolean [write only]
      Set the enabled state of this view. - by default is true.
    • ScaleType As PhotoPagerScaleType
      Controls how the image should be resized or moved to match the size of this ImageView.
      by default is Fit_Center.
    • SetImageForEmptyUri As String [write only]
      Sets own icon on loading.
    • SetImageOnFail As String [write only]
      Sets own icon on fail.
    • ShowMessageError As Boolean [write only]
      Set to true if you want to display an error message.
    • Tag As Object
      Get or Sets the tag associated with PhotoPager. A tag can be used to mark
      a view in its hierarchy and does not have to be unique within the
      hierarchy. Tags can also be used to store data within a view without
      resorting to another data structure.
    • Top As Int
    • Transition As PagerTransitionEffects
      Get or Sets transition effect
    • Version As String [read only]
      Return Author and Version of the library
    • ZoomEnabled As Boolean [write only]
      Sets zoom to the page.


 

Attachments

  • B4APhotoPager_lib_v2.20.zip
    388.7 KB · Views: 774
  • B4APhotoPager_v3.80.zip
    396 KB · Views: 521
  • B4APhotoPager_v3.85.zip
    399 KB · Views: 723
Last edited:

FrankBerra

Active Member
Licensed User
Longtime User
I am using PhotoPager for a while and everything works almost perfectly, but now that my app is close to the launch i am looking everything with more attention.
I noticed that the quality of loaded images is low compared to images loaded with stock gallery. I tried CompressFormat="PNG" and CompressQuality=100 but nothing changes...also CompressQuality=0 gives no results...?!?! (The problem occours also in V. 3.80)
(I am loading images in WEBP format)

What can i do for increasing quality in PhotoPager?

==========

Ciao, sto utilizzanto PhotoPager da parecchio tempo e tutto funziona perfettamente ma adesso che la mia app è prossima al lancio sto controllando tutto con più attenzione. Ho notato che la qualità delle immaggini caricate in PhotoPager è inferiore rispetto alla qualità che riscontro aprendo le immagini con la galleria di sistema.
Ho provato le impostazioni CompressFormat="PNG" e CompressQuality=100 ma non è cambiato nulla...nemmeno CompressQuality=0 produce alcun risultato...?!?!? (Il problema lo riscontro anche nella ultima versione 3.80...perplesso sono)
(Carico e visualizzo immagini nel formato WEBP)

Cosa posso fare per aumentare la qualità delle foto visualizzate in PhotoPager?

Comunque, complimenti per il tuo prezioso contributo alla community! :)
 

lonleystar

Well-Known Member
Licensed User
Longtime User
I am using PhotoPager for a while and everything works almost perfectly, but now that my app is close to the launch i am looking everything with more attention.
I noticed that the quality of loaded images is low compared to images loaded with stock gallery. I tried CompressFormat="PNG" and CompressQuality=100 but nothing changes...also CompressQuality=0 gives no results...?!?! (The problem occours also in V. 3.80)
(I am loading images in WEBP format)

What can i do for increasing quality in PhotoPager?

==========

Ciao, sto utilizzanto PhotoPager da parecchio tempo e tutto funziona perfettamente ma adesso che la mia app è prossima al lancio sto controllando tutto con più attenzione. Ho notato che la qualità delle immaggini caricate in PhotoPager è inferiore rispetto alla qualità che riscontro aprendo le immagini con la galleria di sistema.
Ho provato le impostazioni CompressFormat="PNG" e CompressQuality=100 ma non è cambiato nulla...nemmeno CompressQuality=0 produce alcun risultato...?!?!? (Il problema lo riscontro anche nella ultima versione 3.80...perplesso sono)
(Carico e visualizzo immagini nel formato WEBP)

Cosa posso fare per aumentare la qualità delle foto visualizzate in PhotoPager?

Comunque, complimenti per il tuo prezioso contributo alla community! :)


Hi Franco, honestly I can't tell you now. When I add a new command I use the demo I posted.
Thank you for reporting this issue tomorrow I will give him a look and I'll let You know.

best regard

Giuseppe.

P.S

By default CompressFormat is png and CompressQuality is 100 You should use these two just to change format and reduce the compression.
 

FrankBerra

Active Member
Licensed User
Longtime User
Grande Giuseppe! Ottimo lavoro, grazie!

Super! Now the quality of the displayed images is good! Thank you!


Anyway is it possible to disable the new feature "zoom is reset when the page is changing" or at least apply the reset only when the transition from one page to another is finished and the previous image is not visible anymore?
 
Last edited:

lonleystar

Well-Known Member
Licensed User
Longtime User
Grande Giuseppe! Ottimo lavoro, grazie!

Super! Now the quality of the displayed images is good! Thank you!


Anyway is it possible to disable the new feature "zoom is reset when the page is changing" or at least apply the reset only when the transition from one page to another is finished and the previous image is not visible anymore?


Hi FranK, if I disable the reset zoom, means you have to scroll through 2 pages to get the reset of the previous page.

I don't understand why the previous image is no visible after the Transition to me work fine I don't have this issue.
 

FrankBerra

Active Member
Licensed User
Longtime User
Hi FranK, if I disable the reset zoom, means you have to scroll through 2 pages to get the reset of the previous page.
Let me give a suggestion: I am using horizontalCube transition and if i zoom an image near its border and I try to drag the image (maybe by mistake) the transition starts and the reset of the zoom kicks in. This is not a nice behaviour. I suggest to you to reset the zoom of the image only when it is not visible anymore (simply when the transition from one photo to another is finished)

I don't understand why the previous image is no visible after the Transition to me work fine I don't have this issue.
No i am not experiencing this issue, i was just suggesting you to reset the zoom of an image AFTER the transition (Horizontal Cube transition) is finished.


And also: if i zoom an image and then i drag the zoomed image horizontally with two fingers the images zoom is reset


Another issue i discovered is that on recent devices (Oneplus3) the quality of displayed images is now perfect but on old devices (for example Samsung Galaxy S2) the quality of images is low also with V3.85

Thank you for your support
 
Last edited:

lonleystar

Well-Known Member
Licensed User
Longtime User
Let me give a suggestion: I am using horizontalCube transition and if i zoom an image near its border and I try to drag the image (maybe by mistake) the transition starts and the reset of the zoom kicks in. This is not a nice behaviour. I suggest to you to reset the zoom of the image only when it is not visible anymore (simply when the transition from one photo to another is finished)


No i am not experiencing this issue, i was just suggesting you to reset the zoom of an image AFTER the transition

Another issue i discovered is that on recent devices (Oneplus3) the quality of displayed images is now perfect but on old devices (for example Samsung Galaxy S2) the quality of images is low also with V3.85

Thank you for your support

Hi Frank, I know what you mean I solved the issue of reset because a Member asked to solve it.

I've never tried on a samsung s2, but I can tell you I tried it on the galaxy tab gt-p1000 and s3 with android gingerbread and work fine.
 

MarcoRome

Expert
Licensed User
Longtime User
Hi Giuseppe.
If you havent "ic_error.png" in Files folder the wrapper dont work.
Maybe is better that you fix this or add this in documentation.
Thank you
Ciao
Marco
 

lonleystar

Well-Known Member
Licensed User
Longtime User
Hi Giuseppe.
If you havent "ic_error.png" in Files folder the wrapper dont work.
Maybe is better that you fix this or add this in documentation.
Thank you
Ciao
Marco
Of course, you should put an icon in the resources folder that you want to appear when an error is encountered.
I didn't put it because internet contains thousands of icons and allow you to choose the icon you like to show by ( PhotoPager.SetImageOnFail = "Any Icons" ).


Certamente dovresti mettere un'icona nella cartella delle risorse che desideri che venga visualizzata quando viene rilevato un errore. Io Non l'ho messo perché internet contiene migliaia di icone e lasciare a tutti coloro che usano quasto plugin di scegliere l'icona che piu piace che sia visualizzata.
 

MarcoRome

Expert
Licensed User
Longtime User
Of course, you should put an icon in the resources folder that you want to appear when an error is encountered.
I didn't put it because internet contains thousands of icons and allow you to choose the icon you like to show by ( PhotoPager.SetImageOnFail = "Any Icons" ).


Certamente dovresti mettere un'icona nella cartella delle risorse che desideri che venga visualizzata quando viene rilevato un errore. Io Non l'ho messo perché internet contiene migliaia di icone e lasciare a tutti coloro che usano quasto plugin di scegliere l'icona che piu piace che sia visualizzata.
Thank you for your reply.
Anyway, i think that you should add it in the documentation #1. To understand the problem was it took me half an hour.
In any case, THE LIBRARY IS GREAT ( really good work @lonleystar ).


Grazie per la tua risposta, in ogni caso se aggiungi questo particolare nella documentazione #1 aiuterai gli altri ad evitare di perdere una mezz'oretta di tempo.
La libreria è davvero Ottima ( davvero un ottimo lavoro )
 

lonleystar

Well-Known Member
Licensed User
Longtime User
Thank you for your reply.
Anyway, i think that you should add it in the documentation #1. To understand the problem was it took me half an hour.
In any case, THE LIBRARY IS GREAT ( really good work @lonleystar ).


Grazie per la tua risposta, in ogni caso se aggiungi questo particolare nella documentazione #1 aiuterai gli altri ad evitare di perdere una mezz'oretta di tempo.
La libreria è davvero Ottima ( davvero un ottimo lavoro )


Hi Marco, If you see in the post #1 at the end you will find:

  • SetImageForEmptyUri As String [write only]
    Sets own icon on loading. - Show the icon before loading the image
  • SetImageOnFail As String [write only]
    Sets own icon on fail. - Show the icon error when it encounters an error
Anyway Thanks to you.
 

MarcoRome

Expert
Licensed User
Longtime User
Hi Marco, If you see in the post #1 at the end you will find:

  • SetImageForEmptyUri As String [write only]
    Sets own icon on loading. - Show the icon before loading the image
  • SetImageOnFail As String [write only]
    Sets own icon on fail. - Show the icon error when it encounters an error
Anyway Thanks to you.
Yes i see. But i did not realize that without "icon" the library dont work. I thought it was an option.
Anyway again Thank you very much for this great wrapper
 

Ferdari

Active Member
Licensed User
Longtime User
I think I just found out what the problem was.
The three images (empty_photo.png, ic_error.png, icon.png) in the files dir of the example project ARE REQUIRED by the B4APhotoPager library!
If they are not present you will receive the OutOfMemoryError error.

Giuseppe please mention these files in your documentation :)

I was stuck on this for hours realizing what is wrong, thanks for tip, lonelystar should mention it

Hi, really U dont need The three images (empty_photo.png, ic_error.png, icon.png) but U've to use your own images by ( SetImageForEmptyUri and SetImageOnFail )

Example:

PhotoPager.SetImageForEmptyUri(YourImage.png)

PhotoPager.SetImageOnFail(YourImage.png)

Let me know.

if you dont write this like in the example:

PhotoPager.SetImageForEmptyUri(YourImage.png)
PhotoPager.SetImageOnFail(YourImage.png)


and not copied the files empty_photo.png, ic_error.png, icon.png
the phone just goes blackscreen and starts heatingup trying something on initialize().

please tell its mandatory to use SetImageForEmptyUri and SetImageOnFail if not copied the files.
 
Top