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.

 

[FrankBerra]

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]

Great work Giuseppe
Tried and all work
( Davvero bel lavoro, complimenti Pe )

grazie marco

 

[lonleystar]

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.

 

[lonleystar]

Hi guys, B4APhotoPager has been updated to version 3.85 what's new:

added 5 more Transitions

Fixed the issue reported by FrankBerra.

any comments will be appreciated.

Best Regard.

G.Salvi

 

[FrankBerra]

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?

 

[lonleystar]

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]

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

 

[lonleystar]

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]

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]

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]

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]

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]

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

 

[tuhatinhvn]

Method Click not working???
i can not capture it

 

[Multiverse app]

I know this is an old thread, but I wanted to thank @lonleystar for making this awesome library

 

[Multiverse app]

Method Click not working???
i can not capture it

I too am not able to capture vp_Click event

 

[Ferdari]

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.