FilePlayer Audio Object is used to read the audio content from a file and present them in real time on the output channels. This AO can also be used to add \/ mix the file content with the audio fed into the input channel buffers of this object.<\/p>\n
The object can read from both WAV and PCM files. The WAV file contains the necessary details about the stored audio content in the file whereas the PCM file contains only the audio data and the details such as sampling rate and data format of the stored audio data must be provided separately.<\/p>\n
A background thread is used to read the file contents in bulk and place them in the intermediate cache buffer while in the main thread for each audio interrupt, the required audio data (of framework block length size) is copied from the intermediate cache buffer to the output channel buffers. The background thread periodically checks for the number of samples available in the cache buffer and replenishes from the file(s) as needed.<\/p>\n
The AO can support a configurable number of channels ranging from 1 to 16.<\/p>\n
The AO supports two modes: WAV and PCM to support reading from WAV file and PCM files respectively.<\/p>\n
The WAV or PCM file shall be of two types:<\/p>\n
The FilePlayer AO can be configured with the following additional parameters<\/em><\/strong>:<\/p>\n The FilePlayer has the following Control Inputs:<\/em><\/strong><\/p>\n Single global function control applicable for all channels<\/p>\n 1 \u2013 STOP (default on boot-up)<\/p>\n 2 \u2013 PLAY<\/p>\n 3 \u2013 RESET (STOP followed by PLAY)<\/p>\n 4 \u2013 PAUSE<\/td>\n In Single Multi-Channel mode, the pitch value set through this pin is applicable for all the channels in a given file.<\/p>\n In Multiple Mono mode, this pin controls the pitch of the first channel only<\/td>\n *For SingleMultiChannel mode, only one set of block control input need to be sent. For Multiple Mono mode, for each channel a set of block control need to be sent separately.<\/em><\/p>\n ** All Pitch pins (one or many) will be available only if pitch shifting feature is enabled<\/em><\/p>\n *** The playing speed is controlled by the number of semi-tones (control input value) and is governed by the following formula:<\/em><\/p>\n speed = pow(2, (controlInputValue\/12))<\/p>\n With the control input value ranging from -40 to +40, the playing speed can be varied from 0.1 to 10. The default control input value is 0 and the corresponding play speed is 1.<\/p>\n The FilePlayer has the following Control Output:<\/em><\/strong><\/p>\n Play Position<\/p>\n (Single \/ Block Control)<\/td>\n For every audio interrupt, the AO outputs the play position in terms of percentage covered in the file.<\/p>\n For AOs configured for Single Multichannel mode, only one (N = 1) control output will be there. For AOs configured in Multiple Mono mode, there will be equal number (N) of control outputs for each file – as a single block control output.<\/td>\n <\/p>\n Tuning Parameters<\/strong><\/p>\n All the tuning parameters implemented are unsigned integers and the step value is 1.<\/p>\n State Parameter<\/strong><\/p>\n Function State – This is an Enum variable.<\/p>\n 1 \u2013 STOP (default)<\/p>\n 2 \u2013 PLAY<\/p>\n 3 \u2013 RESET (STOP followed by PLAY)<\/p>\n 4 \u2013 PAUSE<\/p>\n After sending PLAY command through state parameter or Master control pin, the file will be played. After playing the file completely, the object will enter into STOP state (that will not be visible in the Master control pin or this state parameter). However using the readback feature available with this state parameter, the latest state of the FilePlayer object can be known.<\/p>\n In Single Multichannel file mode, mono file also can be played.<\/p>\n Multiple Mono file mode, all the files need to be mono files. In WAV mode, if the file is seen having more than 1 channel, that file will be ignored. In PCM mode, the file will be taken as a mono file and played leading to improper output.<\/p>\n In Multiple Mono file mode, all the mono files need to be in the same data format and sampling rate. If files with different data format are used, the data format of the last configured file will be considered and the same will be applied to all other mono files leading to improper output.<\/p>\n In cases with low intermediate cache buffer size, the background thread need to run frequently to replenish the data available in the cache buffer. If distortion is observed with low cache size, buffer underrun could be the cause and background thread shall be moved to higher priority or the cache buffer size shall be increased.<\/p>\n The memory required for the supporting the intermediate cache buffer size will be slightly more than double the size specified in the additional parameters as it is required to support ping-pong concept and extra data for supporting filtering. The memory latency table shall be referred for exact memory requirements.<\/p>\n In Single Multichannel file, let the number of files present in the file content be M and the number of channels configured for the object be N. FilePlayer Audio Object is used to read the audio content from a file and present them in real time on the output channels. This AO can also be used to add \/ mix the file content with the audio fed into the input channel buffers of this object. The object can read from both WAV […]<\/p>\n","protected":false},"author":90,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"ocean_post_layout":"","ocean_both_sidebars_style":"","ocean_both_sidebars_content_width":0,"ocean_both_sidebars_sidebars_width":0,"ocean_sidebar":"0","ocean_second_sidebar":"0","ocean_disable_margins":"enable","ocean_add_body_class":"","ocean_shortcode_before_top_bar":"","ocean_shortcode_after_top_bar":"","ocean_shortcode_before_header":"","ocean_shortcode_after_header":"","ocean_has_shortcode":"","ocean_shortcode_after_title":"","ocean_shortcode_before_footer_widgets":"","ocean_shortcode_after_footer_widgets":"","ocean_shortcode_before_footer_bottom":"","ocean_shortcode_after_footer_bottom":"","ocean_display_top_bar":"default","ocean_display_header":"default","ocean_header_style":"","ocean_center_header_left_menu":"0","ocean_custom_header_template":"0","ocean_custom_logo":0,"ocean_custom_retina_logo":0,"ocean_custom_logo_max_width":0,"ocean_custom_logo_tablet_max_width":0,"ocean_custom_logo_mobile_max_width":0,"ocean_custom_logo_max_height":0,"ocean_custom_logo_tablet_max_height":0,"ocean_custom_logo_mobile_max_height":0,"ocean_header_custom_menu":"0","ocean_menu_typo_font_family":"0","ocean_menu_typo_font_subset":"","ocean_menu_typo_font_size":0,"ocean_menu_typo_font_size_tablet":0,"ocean_menu_typo_font_size_mobile":0,"ocean_menu_typo_font_size_unit":"px","ocean_menu_typo_font_weight":"","ocean_menu_typo_font_weight_tablet":"","ocean_menu_typo_font_weight_mobile":"","ocean_menu_typo_transform":"","ocean_menu_typo_transform_tablet":"","ocean_menu_typo_transform_mobile":"","ocean_menu_typo_line_height":0,"ocean_menu_typo_line_height_tablet":0,"ocean_menu_typo_line_height_mobile":0,"ocean_menu_typo_line_height_unit":"","ocean_menu_typo_spacing":0,"ocean_menu_typo_spacing_tablet":0,"ocean_menu_typo_spacing_mobile":0,"ocean_menu_typo_spacing_unit":"","ocean_menu_link_color":"","ocean_menu_link_color_hover":"","ocean_menu_link_color_active":"","ocean_menu_link_background":"","ocean_menu_link_hover_background":"","ocean_menu_link_active_background":"","ocean_menu_social_links_bg":"","ocean_menu_social_hover_links_bg":"","ocean_menu_social_links_color":"","ocean_menu_social_hover_links_color":"","ocean_disable_title":"default","ocean_disable_heading":"default","ocean_post_title":"","ocean_post_subheading":"","ocean_post_title_style":"","ocean_post_title_background_color":"","ocean_post_title_background":0,"ocean_post_title_bg_image_position":"","ocean_post_title_bg_image_attachment":"","ocean_post_title_bg_image_repeat":"","ocean_post_title_bg_image_size":"","ocean_post_title_height":0,"ocean_post_title_bg_overlay":0.5,"ocean_post_title_bg_overlay_color":"","ocean_disable_breadcrumbs":"default","ocean_breadcrumbs_color":"","ocean_breadcrumbs_separator_color":"","ocean_breadcrumbs_links_color":"","ocean_breadcrumbs_links_hover_color":"","ocean_display_footer_widgets":"default","ocean_display_footer_bottom":"default","ocean_custom_footer_template":"0","footnotes":"","ocean_post_oembed":"","ocean_post_self_hosted_media":"","ocean_post_video_embed":"","ocean_link_format":"","ocean_link_format_target":"self","ocean_quote_format":"","ocean_quote_format_link":"post","ocean_gallery_link_images":"off","ocean_gallery_id":[]},"categories":[1],"tags":[],"coauthors":[278],"_links":{"self":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/23201"}],"collection":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/users\/90"}],"replies":[{"embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=23201"}],"version-history":[{"count":30,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/23201\/revisions"}],"predecessor-version":[{"id":23967,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/23201\/revisions\/23967"}],"wp:attachment":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=23201"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=23201"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=23201"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcoauthors&post=23201"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\n
\n\n
\n Name<\/strong><\/td>\n Size in Float Words<\/strong><\/td>\n Remarks<\/strong><\/td>\n Range<\/strong><\/td>\n<\/tr>\n \n From<\/strong><\/td>\n To<\/strong><\/td>\n<\/tr>\n \n Block Control*<\/td>\n 4<\/td>\n <\/td>\n <\/td>\n <\/td>\n<\/tr>\n \n Channel ID<\/td>\n 1 of 4<\/td>\n Channel ID to associate with each output channel<\/td>\n 1<\/td>\n 16<\/td>\n<\/tr>\n \n File ID<\/td>\n 2 of 4<\/td>\n The file name need to be a numeral in this range with .wav or .pcm extension. The files shall be placed in the dll folder<\/td>\n 1<\/td>\n 255<\/td>\n<\/tr>\n \n File Setup<\/td>\n 3 of 4<\/td>\n 1 \u2013 One Shot mode and 2 \u2013 Loop mode<\/td>\n 1<\/td>\n 2<\/td>\n<\/tr>\n \n File Start Position<\/td>\n 4 of 4<\/td>\n Start position in percentage from where file will be played<\/td>\n 0<\/td>\n 99<\/td>\n<\/tr>\n \n FilePlayer Function<\/td>\n 1<\/td>\n \n 1<\/td>\n 4<\/td>\n<\/tr>\n \n Pitch** (1)<\/td>\n 1<\/td>\n \n -40<\/td>\n 40***<\/td>\n<\/tr>\n \n Pitch2<\/td>\n 1<\/td>\n Applicable only in Multiple-Mono mode and this pin controls the pitch of the second channel<\/td>\n -40<\/td>\n 40<\/td>\n<\/tr>\n \n PitchN<\/td>\n 1<\/td>\n Applicable only in Multiple-Mono mode and this pin controls the pitch of the Nth channel<\/td>\n -40<\/td>\n 40<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n \n\n
\n Name<\/strong><\/td>\n Size in Float Words<\/strong><\/td>\n Remarks<\/strong><\/td>\n Range<\/strong><\/td>\n<\/tr>\n \n From<\/strong><\/td>\n To<\/strong><\/td>\n<\/tr>\n \n \n N<\/td>\n \n 0<\/td>\n 100<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n \n\n
\n Parameter<\/strong><\/td>\n Description<\/strong><\/td>\n Min<\/strong><\/td>\n Max<\/strong><\/td>\n Default<\/strong><\/td>\n<\/tr>\n \n Fade-in time<\/td>\n Applied for control change from Stop \/ Pause to Play<\/td>\n 0 ms<\/td>\n 1000 ms<\/td>\n 100 ms<\/td>\n<\/tr>\n \n Fade-in type<\/td>\n Linear type only is implemented<\/td>\n 0 (Linear)<\/td>\n 1 (Exponential)<\/td>\n 0 (Linear)<\/td>\n<\/tr>\n \n Fade-out time<\/td>\n Applied for control change from Play to Stop \/ Pause<\/td>\n 0 ms<\/td>\n 1000 ms<\/td>\n 100 ms<\/td>\n<\/tr>\n \n Fade-out type<\/td>\n Linear type only is implemented<\/td>\n 0 (Linear)<\/td>\n 1 (Exponential)<\/td>\n 0 (Linear)<\/td>\n<\/tr>\n \n Fade-out delay<\/td>\n Delay period before starting fade-out process<\/td>\n 0 ms<\/td>\n 100 ms<\/td>\n 0 ms<\/td>\n<\/tr>\n \n Play Speed<\/td>\n Not Implemented<\/td>\n <\/td>\n <\/td>\n <\/td>\n<\/tr>\n \n Pitch ramp time<\/td>\n Applied for\u00a0 any change in pitch value<\/td>\n 0 ms<\/td>\n 100 ms<\/td>\n 0 ms<\/td>\n<\/tr>\n \n Pitch ramp type<\/td>\n Linear type only is implemented<\/td>\n 0 (Linear)<\/td>\n 1 (Exponential)<\/td>\n 0 (Linear)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\nIn WAV mode:
\n– If M = N, all the N channels will be played with the file content.
\n– If M < N, first M channels buffers will be populated with the file content and the remaining N-M channels will be muted.
\n– If M > N, none of the channels will be played and all channels will be muted.
\nIn PCM mode:
\n– If M = N, all the N channels will be played properly with the file content.
\n– If M != N, the file will be taken as a N channel file and played leading to improper output.<\/p>\n","protected":false},"excerpt":{"rendered":"